Apollo-11/CONTRIBUTING.pt_br.md

Contribuindo

🎌 English, Português, Türkçe, العربية, 한국어

O código-fonte neste repositório foi digitado manualmente a partir de impressões em papel, logo alguns erros de digitação e discrepâncias foram introduzidos acidentalmente. O código deve ser modificado para se tornar consistente com as seguintes digitalizações:

• Impressões em AGC para Comanche
• Impressões em AGC para Luminary

Extensões úteis

Github possui suporte de sintaxe nativo para a linguagem assembly AGC. Infelizmente, seu editor de texto não o terá. Portanto, existem extensões para a linguagem AGC que providenciam destaque de sintaxe para os seguintes editores:

• Atom
• Sublime Text 3
• Visual Studio Code

Formatando

Nota: Github e as três extensões listadas acima garantirão que você estará usando a formatação correta automaticamente.

• Use indentação por tab
• Use largura de tab em 8
• Diminua o espaço em branco à direita

O que devo conferir?

Quaisquer discrepâncias entre as digitalizações e o código-fonte neste repositório, incluindo:

Comentários

• Comentários no código transcrito devem corresponder exatamente às digitalizações
  • Isso pode envolver criar um erro de digitação deliberadamente ou remover/adicionar um comentário inteiro.

Quebra de linha

• Quebras de linha com R0000 na coluna 1 devem corresponder exatamente às digitalizações.
• Quebras de linha sem R0000 na coluna 1 devem conter apenas uma ou duas linhas em branco em sequência.
  • Se existem mais de duas quebras de linha em branco, remova as quebras de linha extras.
    • Linhas com R0000 na coluna 1 não contam para este propósito.
  • As imagens fonte foram criadas por meio de um dígito não-impresso na coluna 8. Um 2 forçava um espaço duplo (linha em branco única) e um 3 forçava um espaço triplo (linha em branco dupla). Os valores de 4 até 8 foram definidos porém nunca usados. Leia mais sobre em #159

Por exemplo, o seguinte código:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Deve tornar-se:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Espaços

• Espaços entre dois caracteres na cadeia de caracteres devem respeitar a seguinte convenção (veja a discussão em #316):
  • Espaço único para novas palavras.
  • Espaço duplo para novas sentenças.
  • Espaço triplo para indentações.

Por exemplo, o seguinte código:

	1)  FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
	GARPLY, WALDO.

Deve tornar-se:

	1) FOO BAR BAZ QUX QUUX QUUZ.  CORGE, GRAULT,
	   GARPLY, WALDO.

Notas

Antes de realizar um PR, por favor, certifique-se que suas mudanças estejam consistentes com as digitalizações!