ryan/Apollo-11
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
f12f8691ac
Apollo-11/CONTRIBUTING.ru.md

7.5 KiB
Raw Blame History

Содействие

🎌 Čeština, Deutsch, English, Español, Français, Italiano, Kurdi, Lietuvių, Nederlands, Norsk, Polski, Português, Русский, Türkçe, Ελληνικά, العربية, 日本語, 正體中文, 简体中文, 한국어

Исходный код в этом репозитории был оцифрован вручную с бумажных распечаток, поэтому опечатки и другие расхождения внесены случайно. Код должен быть изменен для соответствия с представленными ниже отсканированными распечатками:

Полезные расширения

GitHub имеет поддержку синтаксиса встроенного языка ассемблера AGC. К сожалению, Ваш редактор кода его не поддерживает, однако есть расширения для языка AGC, которые обеспечивают подсветку синтаксиса в следующих редакторах:

† Поддерживает автоматическое форматирование

Форматирование

Примечание: GitHub и расширения упомянутые выше обеспечат автоматическое использование правильного форматирования.

  • Используйте табуляцию
  • Ширина табуляции равна 8
  • Удаляйте пробелы в конце строк

Что я должен проверять?

Любые расхождения между сканами и исходным кодом в репозитории.

Комментарии

Комментарии в транскрибированном коде ОБЯЗАНЫ В ТОЧНОСТИ соответствовать сканам.

Типичные ошибки на которые следует обратить внимание включают, но не ограничиваются:

Типографические ошибки

В некоторых местах, первичные разработчики делали типографические ошибки во время написания комментариев. Некоторые из них были ошибочно исправлены в процессе оцифровки, однако оцифровывание также должно отображать типографические ошибки которые не присутствуют на сканах.

На пример, если оцифрованный комментарий содержит SPACECRAFT, но в сканах было напечатано SPAECRAFT, то в оцифрованный комментарий ОБЯЗАН быть исправлен на SPAECRAFT (без C).

Также, если оцифрованное слово содержит опечатку, но в сканах ее нет, то опечатка ОБЯЗАНА быть исправлена.

Пробелы

Пробелы между двумя символами в комментариях ДОЛЖНЫ соответствовать сканам. В большинстве случаев (ознакомьтесь с обсуждением #316) это:

  • Одинарный пробел для нового слова.
  • Двойной пробел для нового предложения.
  • Тройной пробел для отступа.

Не все страницы на сканах соответствуют этим правилам, если скан содержит один пробел вместо двух - используйте один.

Разрывы строк

  • Разрывы строк содержащие R0000 в столбце 1 должны в точности соответствовать сканам.
  • Разрывы строк без R0000 в столбце 1 должны содержать только 1 или 2 пустые строки подряд.
    • Если более 2 пустых строк - уберите лишние разрывы строк.
      • Строки с R0000 в столбце 1 не считаются пустыми.
    • В исходных изображениях они были созданы ненапечатанной цифрой в столбце 8. 2 принудительно использует двойной пробел (одна пустая строка), а 3 принудительно использует тройной пробел (две пустые строки). Значения 4-8 были определенны, но никогда не использовались. Читайте подробнее в #159

На пример:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Должно быть изменено на:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Примечание

Перед созданием PR, пожалуйста, убедитесь, что Ваши изменения соответствуют сканам!