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

Escrever o curso utilizando reStructuredText e Sphinx #15

@tiagoamartins

Description

@tiagoamartins

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?)

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions