Contribuindo com o Adoptium®

Obrigado pelo seu interesse neste projeto.

Descrição do projeto

O Adoptium é um projeto de código aberto focado em fornecer distribuições de alta qualidade e prontas para produção do Java Development Kit (JDK) e tecnologias associadas. O principal objetivo do projeto é criar uma distribuição do OpenJDK orientada pela comunidade e independente de fornecedores, que é a implementação de código aberto da Plataforma Java, Edição Padrão (Java SE).

O Adoptium visa fornecer aos usuários builds confiáveis e bem testados do OpenJDK em diferentes plataformas, incluindo Windows, macOS, Linux e mais. O projeto colabora estreitamente com a comunidade OpenJDK e se beneficia da expertise de um grupo diversificado de colaboradores, incluindo desenvolvedores, organizações e entusiastas de Java.

Um dos principais objetivos do Adoptium é facilitar o acesso e o consumo de builds do OpenJDK por desenvolvedores e organizações. Ele fornece binários pré-compilados que são amplamente testados, garantindo estabilidade e compatibilidade. Esses binários são disponibilizados gratuitamente, tornando conveniente para os desenvolvedores adotar e usar o OpenJDK em seus projetos sem quaisquer restrições de licenciamento.

O Adoptium também oferece builds com suporte de longo prazo (LTS), especificamente projetados para empresas e organizações que precisam de um ambiente de runtime Java estável e confiável. Os builds LTS recebem atualizações regulares e patches de segurança, garantindo a longevidade e manutenção da plataforma Java.

Em geral, o Adoptium visa fornecer uma distribuição confiável e acessível do OpenJDK, promovendo transparência, colaboração e inovação orientada pela comunidade no ecossistema Java.

https://github.com/adoptium

Recursos para desenvolvedores

O projeto Adoptium mantém os seguintes repositórios de código-fonte:

Eclipse Contributor Agreement

Antes que sua contribuição possa ser aceita pela equipe do projeto, os colaboradores devem assinar eletronicamente o Eclipse Contributor Agreement (ECA).

http://www.eclipse.org/legal/ECA.php

Commits fornecidos por não-committers devem ter um campo Signed-off-by no rodapé indicando que o autor está ciente dos termos pelos quais a contribuição foi fornecida ao projeto. O não-committer deve, adicionalmente, ter uma conta na Eclipse Foundation e um Eclipse Contributor Agreement (ECA) assinado registrado.

Para mais informações, consulte o Eclipse Committer Handbook e a documentação do Adoptium:

Enviando uma contribuição ao Adoptium

Após assinar o ECA, você pode propor contribuições enviando pull requests (PRs) pelo GitHub.

Nota: Assumindo que estamos contribuindo para o repositório aqa-tests

Se esta é sua primeira contribuição ao projeto, faça um fork do repositório clicando no botão Fork no canto superior direito da página do repositório no git. Isso cria uma cópia do repositório na sua conta do GitHub: https://github.com/<YourGitUserName>/aqa-tests.git

Clone seu repositório com git:

git clone https://github.com/<YourGitUserName>/aqa-tests.git

Crie um novo branch para trabalhar:

cd aqa-tests
git checkout -b my_new_branch

Adicione https://github.com/adoptium/aqa-tests.git como seu upstream:

git remote add upstream https://github.com/adoptium/aqa-tests.git

Antes de começar a trabalhar na issue, certifique-se de que o branch local está atualizado:

git fetch upstream
git rebase upstream/master

Após concluir seu trabalho, registre suas alterações e faça o commit.

git add .
git commit -s -m "message about this PR"

Exemplo de mensagem de commit:

Update jtreg in openjdk test
This patch updates jtreg version from 5.1 to 6.1.
Fixes: #1234
Signed-off-by: Full Name <email>

A primeira linha é o título do PR. Ela deve descrever a alteração feita. Mantenha-a curta e simples.
O corpo deve incluir informações detalhadas sobre o seu PR. Você pode querer incluir designs, justificativas e uma breve explicação do que foi alterado. Mantenha-o conciso.
Quando um commit tiver issues relacionadas, use as palavras-chave do Git para fechar ou relacionar automaticamente às issues. https://help.github.com/articles/closing-issues-using-keywords/
Por favor, assine seu commit no rodapé. Isso pode ser adicionado automaticamente ao seu commit passando -s ao git commit (veja o exemplo acima).

Envie a alteração para o seu repositório Git:

git push origin my_new_branch

Você pode usar -f no git push se precisar sobrescrever seu histórico do git. Use este flag com cuidado.

Encorajamos você a abrir um pull request cedo e usar a opção Create draft pull request. Isso permite que outros verifiquem o PR, obtenham feedback antecipado e ajuda a criar um produto final melhor.

Se você tiver acesso para executar jobs de teste em nosso servidor Jenkins, execute o Grinder para validar seu PR. Se não tiver acesso, os revisores do seu PR executarão alguns testes. Os revisores podem pedir que você execute testes extras dependendo das alterações que você fez no PR.

Certifique-se de que todos os jobs do Grinder relacionados passem e forneça os links do Grinder no comentário do PR. Suas alterações também devem passar nos builds automáticos de PR que serão aplicados ao seu pull request.

Converta o PR para Ready for review quando estiver pronto.