Skip to content
This repository has been archived by the owner on Oct 3, 2018. It is now read-only.

Escrever o curso utilizando reStructuredText e Sphinx #15

Open
tiagoamartins opened this issue Jun 13, 2017 · 1 comment
Open

Escrever o curso utilizando reStructuredText e Sphinx #15

tiagoamartins opened this issue Jun 13, 2017 · 1 comment

Comments

@tiagoamartins
Copy link
Contributor

Acham que vale a pena converter o curso de Jupyter Notebook para reStructuredText e utilizar Sphinx? Colocar no ReadTheDocs talvez?

Algumas vantagens ao meu ver:

  • Facilitaria o gerenciamento dos pull requests
  • Ficaria mais fácil de atualizar
  • Fica bem bonito depois de compilado
  • Da pra colocar arquivos .py e "linkar" com o material (o que para cursos mais avançados é bem interessante.)
  • Esse cara usa nas apresentações: Raymond Hettinger

Desvantagens:

  • Tem que converter o que já tem
  • Os alunos perdem a possibilidade de utilizar o próprio material para resolver os exercícios (embora eu acho que o Jupyter está sendo utilizando somente para o ministrante, certo?)
@heitorPB
Copy link
Member

Outra vantagem:
Dá para gerar um pdf bonitão de brinde.

Eu acho válido.

@tiagoamartins tiagoamartins changed the title Escrever o curso utilizando reStructuredText and Sphinx Escrever o curso utilizando reStructuredText e Sphinx Jun 15, 2017
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants