Apollo-11/CONTRIBUTING.pt_br.md
James Harris ee70f0891b
Add Chinese CONTRIBUTING.md links to TR and PT_BR (#554)
* Add Chinese CONTRIBUTING.md links to TR and PT_BR

* Add Chinese CONTRIBUTING.md links to TR and PT_BR
2020-01-07 17:51:35 +00:00

3.7 KiB

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:

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:

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!