Read this guide in other languages
Este é um projeto de código aberto relativamente simples e amigável para iniciantes, que é uma excelente escolha para contribuir para aqueles que desejam fazer as suas primeiras contribuições de código aberto. No entanto, qualquer pessoa é livre para contribuir.
O objetivo deste projeto é criar uma base de dados de algoritmos usando a linguagem de programação que preferires, onde cada algoritmo retornará o enésimo elemento de uma das notáveis sequências inteiras listadas no seguinte link da Wikipedia: https://en.wikipedia.org/wiki/List_of_integer_sequences
Este link da Wikipedia contém uma lista de muitas sequências inteiras notáveis, como os números primos, a sequência de Kolakoski, números de Motzkin, números de Lucas, etc ...
'n' Representa uma entrada de um número inteiro pelo utilizador. Por exemplo, se o utilizador inserir o inteiro '2', então o seu algoritmo deve retornar o terceiro elemento da sequência (porque a indexação começa em 0, o primeiro elemento da sequência é n = 0, o segundo elemento é n = 1, etc).
Se alguém precisar de implementar uma das sequências inteiras mais obscuras listadas na página da Wikipedia no seu programa, é provável que tenham que desenvolver o seu próprio algoritmo do zero para encontrar o enésimo elemento da sequência, já que nenhum código para gerar essas sequências obscuras existirá na Internet.
Quero completar a base de dados dos algoritmos deste projeto para que outras pessoas possam simplesmente usar os algoritmos desta base de dados, em vez de perder tempo a desenvolver os seus próprios algoritmos. Qualquer pessoa é livre para usar o código deste projeto no seu software, não há necessidade de pedir permissão porque este projeto usa o Unlicense.
Vê o seguinte link da Wikipedia: https://en.wikipedia.org/wiki/List_of_integer_sequences
Observa a lista de sequências inteiras notáveis e desenvolve um algoritmo em qualquer linguagem de programação para retornar o enésimo elemento da sequência. A indexação começa em 0, portanto, se o utilizador inserir n = 0, ele retornará o primeiro elemento da sequência, n = 1 retornará o segundo elemento, etc. Observa o repositório do projeto para garantir que o código para a tua sequência inteira de escolha ainda não tenha sido adicionada ao projeto na tua linguagem de programação.
Por exemplo, se alguém criou um algoritmo Python para os números de Bell e adicionou'o ao projeto, ainda podes criar um algoritmo para os números de Bell em qualquer outra linguagem, mas não com Python.
Se nenhum código para uma sequência inteira específica existir no repositório do projeto, podes criar código para essa sequência inteira em qualquer linguagem de programação.
Observa o código que já existe no repositório do projeto, usa-o para guiar-te e ajudar-te a desenvolver o teu próprio algoritmo.
Quando estiveres satisfeito com o código que desenvolveste, envia um pull request. Em seguida, verificarei o teu código para garantir que ele funciona conforme o esperado e, em seguida, adicionarei ao repositório do projeto. Se o teu código produzir as saídas corretas, ele será sempre adicionado ao repositório do projeto, independentemente dos padrões de codificação / qualidade do código e independentemente da velocidade do código.
Também podes modificar e melhorar o código existente dentro do projeto, enviar um pull request e eu verificarei as tuas alterações. Por exemplo, podes melhorar a velocidade do código ou melhorar os padrões de codificação adicionando comentários, espaços, alterando nomes de variáveis, etc.
Como este é um projeto virado para iniciantes, quero explicar brevemente a maneira mais simples de enviar um pull request para quem não sabe.
Abre o repositório e clica em "Fork". Isto cria uma cópia bifurcada do repositório.
Adiciona o teu código à cópia bifurcada.
Volta ao meu repositório e clica em enviar pull request. Clica em "comparar entre forks". Seleciona a tua cópia bifurcada do repositório como cabeçalho e o meu repositório como base.
Clica em enviar um pull request e deixa um comentário significativo explicando o código que estás a tentar adicionar ao projeto.
Em alternativa, podes usar os seguintes comandos git:
- Para clonar o repositório no teu sistema local, usa
git clone repo-link nome_pasta
- Para fazer staging do ficheiro que acabaste de alterar, usa
git add nome_ficheiro
- No caso de teres alterado vários ficheiros e quiseres adicioná-los todos de uma vez, usa
git add .
- Para confirmar essas mudanças, usa
git commit -m "Problema corrigido #issue_number"
- Para submeter essas mudanças, usa
git push origin nome_Branch