-
Devem criar uma conta no GitHub, depois de criada a conta abram o link para o editor de exercícios.
-
No editor de exercícios devem criar as pastas com os exercícios que querem adicionar, usando como modelo a pasta template, aí devem fazer o enunciado do exercício no ficheiro question.md, obter a print do exercício e guardá-la na pasta. Devem criar o(s) ficheiro(s) com a(s) tip(s) em markdown (.md) e gerar também a print. No fim de terem feito isto, preencham o ficheiro info.json.
-
Quando terminarem, abram a aba lateral "Source Control", escrevam a mensagem "adicionar exercícios" na caixa de texto para a mensagem e carreguem em "Commit & Push". Se é a primeira vez que submetem um exercício, vai-vos aparecer um aviso, devem carregar em "Fork Repository", carregam no Enter quando vos aparecer uma caixa de texto e depois em "Switch to Fork".
-
Carreguem em "Source Control", selecionem "Pull Request" e "Create Pull Request", carreguem no botão azul para criar e finalmente carreguem no botão azul "Checkout 'main'".
-
Os exercícios foram enviados para nós, que faremos uma validação manual e serão posteriormente adicionados à plataforma.
Na pasta exercises podem ser encontrados os anos escolares para os quais há exercícios (não devem criar mais anos, usem apenas os que já lá estão).
Em cada uma destas pastas podem encontrar várias disciplinas (à semelhança dos anos, não devem criar mais disciplinas, usem apenas as que já lá estão).
Dentro da pasta de cada disciplina vão encontrar pastas com os vários domínios da disciplina.
Em cada uma destas pastas vão encontrar pastas com os temas específicos de cada domínio.
É nesta pasta que serão feitas as contribuições de exercícios.
Cada uma destas pastas é formada por um nome (primeiro e último, sem acentos) e um número, por exemplo JoaoGuilherme_1, o nome indica quem submeteu e o número indica o número de exercícios sobre aquele tema que a pessoa já publicou.
Dentro de cada pasta encontram um ficheiro info.json, ficheiros markdown (.md), um para o enunciado e um ou mais para as tips. Para cada ficheiro markdown encontram também a respetiva imagem (.png).