Documentação é algo que todos gostam de ler, mas quase ninguém gosta de fazer. Se ela é tão importante, por que não investir um tempinho para ajudar os futuros mantenedores do código? Seja essa pessoa alguém que acabou de entrar no projeto ou (pasme!) você mesmo(a).

Sphinx é um gerador de documentação. Ele é fácil de ser usado, já que reconhece docstrings.

Nessa palestra vamos decifrar juntos a Esfinge da documentação e torcer para não sermos devorados.


Público-alvo: pessoas que já têm certo envolvimento com programação em Python

O que esperar da palestra:

1. Entender a importância da documentação

2. Saber o essencial de como se usa a ferramenta

Documentação é algo que todos gostam de ler, mas quase ninguém gosta de fazer. Se ela é tão importante, por que não investir um tempinho para ajudar os futuros mantenedores do código? Seja essa pessoa alguém que acabou de entrar no projeto ou (pasme!) você mesmo(a).

Sphinx é um gerador de documentação. Ele é fácil de ser usado, já que reconhece docstrings.

Nessa palestra vamos decifrar juntos a Esfinge da documentação e torcer para não sermos devorados.

Público-alvo: pessoas que já têm certo envolvimento com programação em Python

O que esperar da palestra:

1. Entender a importância da documentação

2. Saber o essencial de como se usa a ferramenta

Robolt-0 é uma plataforma robótica projetada para ser usada em diferentes aplicações, a principal delas: o ensino de robótica e programação através da montagem do hardware e criação de aplicativos de controle e monitoramento do robô. Pode ser empregado, ainda, em testes de inteligência artificial, facilitando a coleta e análise de dados ao prover uma arquitetura genérica e bem definida. Ele é extensível, permitindo que novos componentes possam ser adicionados facilmente, e open-source, possibilitando sua evolução e facilitando a padronização, além do intercâmbio de aplicações. E o melhor: tanto a modelagem gráfica da estrutura quanto seu código base foram feitos em Python!

Em uma pesquisa (não tão séria) sobre as dificuldades das pessoas em conceitos de programação, loop foi um dos assuntos mais mencionados. Por mais que seja um assunto visto no começo do estudo de lógica, não custa nada repetir.