Shapely: Compilações automáticas de documentos

Aliás, matplotlib já faz isso. Veja https://github.com/matplotlib/matplotlib/blob/master/.travis.yml#L126

Eu definitivamente acho que o processo poderia ser melhorado...

Além disso, acabei de descobrir que o ReadTheDocs agora pode fazer instalações conda, tornando o RTD uma opção viável para a construção de documentos Shapely (fiz uma prova de conceito para Cartopy com algum sucesso).

Eu tentei isso e tenho algo funcionando, com base neste tutorial: https://gist.github.com/domenic/ec8b0fc8ab45f39403dd

As mudanças estão aqui: https://github.com/Toblerity/Shapely/compare/master...snorfalorpagus :autodoc

O processo requer que você crie um novo par de chaves SSH e coloque uma versão criptografada da chave privada no repositório/Travis.

Ele está configurado para compilar a documentação apenas em uma instância (o Python 3.5 com acelerações). https://travis-ci.org/snorfalorpagus/Shapely/jobs/177188968

Isso destacou que alguns dos scripts que criam figuras na documentação não são compatíveis com o Python 3.x, por exemplo, buffer.py que fornece:

Traceback (most recent call last):
  File "buffer.py", line 29, in <module>
    ax.set_xticks(range(*xrange) + [xrange[-1]])
TypeError: unsupported operand type(s) for +: 'range' and 'list'

@snorfalorpagus antes de gastar mais tempo com isso, deixe-me ver se nossas rodas manylinux1 ajudam a tornar o readthedocs uma opção melhor.

Também quero aumentar a conscientização sobre https://github.com/drdoctr/doctr se você descer os documentos na rota travis.

Estou movendo este para o próximo marco. Eu gostaria de desbloquear 1.6.0 e trabalhar na infra doc depois.