Decidir o formato padrão para doscstrings no repositório

[augusto-herrmann]

Precisamos decidir um formato padrão para usar nas docstrings do repositório, documentá-lo nas instruções de contribuição e adaptar as docstrings em todos os módulos Python para que fiquem em conformidade com essa decisão.

Algumas possibilidades de estilo de docstring:

• Epytext
• reST (exemplo)
• Google (exemplo)
• numpy (exemplo)

A PEP 287 recomenda o estilo reST. Porém muitos módulos deste repositório já estão usando Google style docstrings.

Mais informações:

• What is the standard Python docstring format (Stack Overflow)
• Python docstrings styles - Krystian Safjan's Blog