Diretrizes de Contribuição

Welcome to the contribution guidelines for the frc-docs project. If you are unfamiliar to writing in the reStructuredText format, please read up on it here.

Importante

FIRST® retains all rights to documentation and images provided. Credit for articles/updates will be in the GitHub commit history.

Declaração de Missão

A Missão da WPILib é permitir que as equipes da FIRST Robotics se concentrem em escrever software específico para jogos ao invés de se concentrar em detalhes de hardware - «eleve o chão, não abaixe o teto». Trabalhamos para permitir que equipes com conhecimento de programação limitado e/ou com experiência de mentor tenham o maior sucesso possível, sem prejudicar as habilidades de equipes com capacidade de programação mais avançada. Oferecemos suporte aos componentes do sistema de controle do Kit of Parts diretamente na biblioteca. Nós também nos esforçamos para manter a paridade entre os principais recursos de cada linguagem (Java, C++ e LabVIEW da NI), para que as equipes não fiquem em desvantagem ao escolher uma linguagem de programação específica.

Esses documentos servem para fornecer um campo de aprendizagem para todas as equipes da FIRST Robotics Competition. As contribuições para o projeto devem seguir estes princípios básicos.

  • Documentação liderada pela comunidade. As fontes de documentação são hospedadas publicamente e a comunidade pode fazer contribuições

  • Documentação estruturada, bem formatada e limpa. A documentação deve ser limpa e fácil de ler, tanto do ponto de vista da fonte quanto o da versão lançada

  • Relevante. A documentação deve ser focada na FIRST Robotics Competition.

Por favor, veja o Guia de Estilo para informações sobre como estilizar sua documentação.

Processo de Lançamento

frc-docs usa um processo de lançamento especial para lidar com o site principal /stable/ e o site de desenvolvimento /latest/. O fluxo desse processo é detalhado abaixo.

Durante a Temporada:

  • Commit é feito para o branch main

    • Atualiza /stable/ e /latest/ no site

Fim da Temporada:

  • Repositório é marcado com um ano, para propósitos de arquivamento

Off-Season:

  • branch stable é bloqueado no último commit feito ainda na temporada

  • Commit é feito para o branch main

    • Apenas atualiza /latest/ no site da documentação

Criando uma PR

PRs should be made to the frc-docs repo on GitHub. They should point to the main branch and not stable.

Criando Conteúdo Novo

Thanks for contributing to the frc-docs project! There are a couple things you should know before getting started!

Onde colocar os artigos?

A localização de novos artigos pode ser um tema controverso. Artigos isolados que se encaixam bem em uma categoria devem ser colocados na respectiva categoria (documentação de algo sobre simulação deve ser colocado na seção de simulação). Porém, as coisas podem ficar complicadas quando um artigo combina ou faz referência a duas seções distintas. Nessa situação, recomendamos ao autor que abra um issue no repositório, para gerar uma discussão antes da abertura da PR.

Nota

Todos os novos artigos passarão por um processo de revisão antes de serem integrados ao repositório. Esse processo de revisão será feito por membros da equipe WPILib. Novos Artigos devem ser sobre software e hardware com suporte oficial FIRST. Documentação em bibliotecas ou sensores não oficiais não serão aceitos. Esse processo pode levar algum tempo para ser revisado, por favor seja paciente.

Onde colocar seções?

Sections are quite tricky, as they contain a large amount of content. We advise the author to open an issue to gather discussion before opening up a PR.