Apollo-11/CONTRIBUTING.pt_br.md

165 lines
5.9 KiB
Markdown
Raw Normal View History

# Contribuindo
🎌
2020-10-04 11:47:13 -04:00
[Čeština][CZ],
2020-05-05 13:30:37 -04:00
[Deutsch][DE],
[English][EN],
[Español][ES],
[Français][FR],
[Kurdi][KU],
[Nederlands][NL],
**Português**,
[Türkçe][TR],
[العربية][AR],
[日本語][JA],
[正體中文][ZH_TW],
[简体中文][ZH_CN],
[한국어][KO_KR]
[AR]:CONTRIBUTING.ar.md
2020-10-04 11:47:13 -04:00
[CZ]:CONTRIBUTING.cz.md
2020-05-05 13:30:37 -04:00
[DE]:CONTRIBUTING.de.md
[EN]:CONTRIBUTING.md
[ES]:CONTRIBUTING.es.md
[FR]:CONTRIBUTING.fr.md
[JA]:CONTRIBUTING.ja.md
[KO_KR]:CONTRIBUTING.ko_kr.md
[KU]:CONTRIBUTING.ku.md
[NL]:CONTRIBUTING.nl.md
[PT_BR]:CONTRIBUTING.pt_br.md
[TR]:CONTRIBUTING.tr.md
[ZH_CN]:CONTRIBUTING.zh_cn.md
[ZH_TW]:CONTRIBUTING.zh_tw.md
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:
2020-06-01 19:29:19 -04:00
- [Impressões em AGC para Comanche][8]
- [Impressões em AGC para Luminary][9]
## 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:
2020-06-01 19:29:19 -04:00
- [Atom][Atom]†
- [CodeBlocks][CodeBlocks]
- [Eclipse][Eclipse]
- [Kate][Kate]
- [ProgrammersNotepad][ProgrammersNotepad]
- [Sublime Text 3][Sublime Text]†
- [TextPad][TextPad]
- [Vim][Vim]
- [Visual Studio Code][VisualStudioCode]†
- [jEdit][jEdit]
† Suporta formatação automática
[Atom]:https://github.com/Alhadis/language-agc
[CodeBlocks]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/CodeBlocks
[Eclipse]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Eclipse
[Kate]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/Kate
[ProgrammersNotepad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/ProgrammersNotepad
[Sublime Text]:https://github.com/jimlawton/AGC-Assembly
[TextPad]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/TextPad
[Vim]:https://github.com/wsdjeg/vim-assembly
[VisualStudioCode]:https://github.com/wopian/agc-assembly
[jEdit]:https://github.com/virtualagc/virtualagc/tree/master/Contributed/SyntaxHighlight/jEdit
## Formatando
2020-06-01 19:29:19 -04:00
**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?
2020-06-01 19:29:19 -04:00
Quaisquer discrepâncias entre as digitalizações e o código-fonte neste repositório, incluindo:
### Comentários
2020-06-01 19:29:19 -04:00
- Comentários no código transcrito devem corresponder exatamente às digitalizações
2020-10-09 15:24:42 -04:00
- 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
2020-06-01 19:29:19 -04:00
- 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][7]
Por exemplo, o seguinte código:
2020-06-01 19:29:19 -04:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0821 LAMPTEST CS IMODES33
```
2020-06-01 19:29:19 -04:00
Deve tornar-se:
2020-06-01 19:29:19 -04:00
```plain
R0819 SUBROUTINE TO SKIP...
R0820
0820 LAMPTEST CS IMODES33
```
### Espaços
2020-06-01 19:29:19 -04:00
- Espaços entre dois caracteres na cadeia de caracteres devem respeitar a seguinte convenção (veja a discussão em [#316][10]):
- 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:
2020-06-01 19:29:19 -04:00
```plain
1) FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
GARPLY, WALDO.
```
2020-06-01 19:29:19 -04:00
Deve tornar-se:
2020-06-01 19:29:19 -04:00
```plain
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!
[0]:https://github.com/chrislgarry/Apollo-11/pull/new/master
[1]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[2]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[6]:https://github.com/wopian/agc-assembly#user-settings
[7]:https://github.com/chrislgarry/Apollo-11/issues/159
[8]:http://www.ibiblio.org/apollo/ScansForConversion/Comanche055/
[9]:http://www.ibiblio.org/apollo/ScansForConversion/Luminary099/
[10]:https://github.com/chrislgarry/Apollo-11/pull/316#pullrequestreview-102892741