Open marinaaguiar opened 3 years ago
Muito interessante essa sua issue @marinaaguiar acho muito legal tentar indicar claramente o que é da API, do vocabulário de funções, que vem do Processing, pode ser algum muito útil mesmo.
Tentei fazer um pouquinho isso aqui (para um assunto restrito, os "tipos'") em uma coluna "origem", veja o que você acha? https://github.com/villares/material-aulas/blob/master/Processing-Python/tipagem_py.md#alguns-tiposclasses-de-valoresobjetos
Vejo algumas maneiras de tentarmos fazer, não são muito fáceis mas acho que com ajuda rolaria:
De qualquer forma acho que precisaríamos vasculhar as páginas e identificar os itens mencionados de maneira sistemática e ainda não sei muito bem como conduzir isso...
A tabela com a coluna de origem já ajuda bastante! :) Mas acho que didaticamente seria interessante alguma indicação mais visual... como uma distinção em cores que poderia ser aplicado no realce do texto atrás; (aí no final de cada post ter uma legendinha Py=azul P5=vermelho). Pois hoje já tem essa marcação cinza para indicar que é um tipo/classe, aí só alteraria a cor para referenciar a origem.
Puxa ia ficar muita legal com cores sim! Esse cinza eu não tenho como controlar neste formato que estou fazendo o material (que é o "markdown") ele fica desse jeito quando indico que é código com esses "backticks" (`). Mas vou pensar aqui em mais ideias.
Ideia: Anotações no final das páginas sobre o vocabulário.
Acho que seria interessante um conteúdo que listasse alguns comparativos do que é vocabulário do processing e o que é estritamente vocabulário utilizado em python.
Sei que é possível pesquisar pela documentação de ambos separadamente, como achei do processing nesse link https://pt.khanacademy.org/computing/computer-programming/pjs-documentation e também muito conteúdo aqui no próprio material do prof. Villares (que é excelente); mas confesso que essa dúvida foi recorrente ao longo do trabalho para entender como diferenciar essas duas linguagens.