Apollo-11/CONTRIBUTING.pt_br.md
2020-10-09 16:29:01 -03:00

5.5 KiB

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:

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:

† 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.

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!