COMO-CONTRIBUIR

Como contribuir para o Microfundamentos

Clique aqui para acessar o repositório

Você já teve alguma ideia que pode contribuir para o repositório? Se sim, seja bem vindo, aqui eu irei mostrar como você pode contribuir para esse repositório!

Corrigindo erros

As vezes durante sua leitura dos microfundamentos, você deve ter encontrado erros de gramática ou até erros factuais, se isso acontecer, reporte esses erros na aba Issues do nosso github e iremos corrigir isso.

Dando início a sua aula

Caso você esteja interessado em fazer uma aula, primeiramente lembre-se que a aula precisa de um nome, e precisa que esse nome venha no nome do arquivo e na primeira linha do arquivo. E em sequêcia deve vir o nome do professor da aula (neste caso o seu). Para efeitos práticos, segue um exemplo, eu tenho uma aula de Quicksort então o nome do arquivo será: Quicksort.md e no começo do arquivo a sua aula está assim:

# Quicksort

# Fulano de Tal

Obs.: Se você quiser colocar o nome do arquivo uma coisa, e o nome da aula outro, você pode, desde que ambos contenham a mesma palavra chave, então por exemplo, o nome do arquivo pode ser Quicksort.md e a aula pode ter o nome:

# Entendendo o algoritmo Quicksort

# Fulano de Tal

A aula em si

Agora você irá montar o conteúdo da aula, aqui você terá uma maior liberdade em como seguir o seu roteiro, mas em geral, algumas coisas eu recomendo para todos.

Primeiro, coloque o conteúdo da aula e seus pré-requisitos no começo

É importante que toda aula mantenha o aluno informado no que ele vai aprender, além dos pré-requisitos necessários para acompanhar a aula, até porque se você, por exemplo, fizer uma aula sobre o algoritmo Quicksort, você precisa assumir que o aluno vai entender conceitos básicos como: Complexidade e o que significa ser um Algoritmo de Ordenação Interna. Neste caso é importante você coloque isso acompanhado do título:

# O que você vai aprender

- O que é o Quicksort
- Entender o funcionamento do algoritmo 
- Complexidade de tempo e espaço do algoritmo

# Pré-requisitos
- Noções básicas sobre Complexidade de Algoritmo
- Noções básicas de Ordenação interna

Segundo, separe cada parte do aprendizado em seções

Para cada parte da aula separe a apresentação de cada ideia em seção, então por exemplo nessa nossa aula de quicksort, coloque cada um tópicos para aprendizado em seções diferentes para que você possa deixar ainda mais claro o fluxo da aula para o aluno.

Então por exemplo.

# O que é o Quicksort

O quicksort é um algoritmo de ordenação interna criado por ....


# Entender o funcionamento do algoritmo

Agora que você entende o que é o algoritmo, vamos agora mostrar um exemplo prático de como um conteúdo de dados será organizado, considere o arranjo 
de números abaixo

Toda informação tem uma origem, então não se esqueça de colocar de onde tirou essas informações, além de links para que o aluno possa continuar o aprendizado daquele tópico.

# Links

- Leia mais sobre o Quicksort (link aqui)
- Implementando o Quicksort em C (link aqui)

Conclusão

Então é isso, estes são os elementos que vocês precisam levar em consideração na hora de criar uma aula, espero que isso tenha esclarecido suas dúvidas, e que dessa forma vocês consigam criar novas aulas que possam inspirar a próxima geração de programadores. Caso tenham mais dúvidas, podem entrar em contato comigo. Muito obrigado e bom dia :-)

Last updated