Apollo-11/CONTRIBUTING.pt_br.md

Contribuindo

🎌 Čeština, Deutsch, English, Español, Français, Kurdi, Nederlands, 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†
• CodeBlocks
• Eclipse
• Kate
• ProgrammersNotepad
• Sublime Text 3†
• TextPad
• Vim
• Visual Studio Code†
• jEdit

† Suporta formatação automática

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
• Questões comuns que você deve ficar atento durante a prova incluem, mas não se limitando a:

Erros tipográficos

Em alguns lugares, os desenvolvedores originais cometeram erros tipográficos ao escrever comentários. Alguns deles foram erroneamente corrigidos durante a digitalização inicial, porém a digitalização também introduziu erros tipográficos que não estavam presentes nas digitalizações. Por exemplo, se os comentários digitalizados contiveram SPACECRAFT , mas SPAECRAFT foram impressos nas digitalizações, então a digitalização deve ser corrigida para SPAECRAFT(faltando o C). Da mesma forma, se uma palavra tem um erro de digitação, mas é escrita corretamente nas digitalizações, então o erro de digitação deve ser corrigido.

Espaços

Espaços entre dois caracteres em comentários DEVEM coincidir com as digitalizações. Na maioria dos casos (veja a discussão em [#31610),isto é:

-Espaço único para novas palavras. -Espaço duplo para novas frases. -Espaço triplo para recuos.

Nem todas as páginas nas digitalizações seguem essa generalização, se os scans tiverem apenas um único espaço em vez de um espaço duplo, use um único espaço.

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!