kjodle/Apollo-11
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity
dcc296468c
Apollo-11/CONTRIBUTING.ua.md
allozavrr 495a563fd1
Add Ukrainian README and CONTRIBUTING (#903) 
* Add: Ukrainian language

* Fix: grammar mistakes

* Fix: grammar mistakes
2023-10-02 19:40:05 +01:00

7.4 KiB
Raw Blame History

Contributing

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

Вихідний код у цьому репозиторії було оцифровано вручну з паперових роздруківок, тому помилки та інші розбіжності були внесені випадково. Код необхідно змінити, щоб узгодити його з такими сканованими роздруківками:

Корисні розширення

GitHub має вбудовану підтримку синтаксису для мови асемблера AGC. На жаль, ваш редактор коду цього не зробить, однак існують розширення мови AGC, які забезпечують підсвічування синтаксису для таких редакторів:

† Підтримує автоматичне форматування

Форматування

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

  • Використовуйте відступ через TAB.
  • Використовуйте TAB шириною (width) у 8.
  • Видаляйте кінцеві пробіли.

Що мені перевірити?

Будь-які розбіжності між сканами та вихідним кодом у цьому репозиторії.

Коментарі

Коментарі в транскрибованому коді МАЮТЬ точно збігатися зі сканами.

Поширені проблеми, на які слід звернути увагу під час перевірки, вміщують, але не обмежуються таким:

Друкарські помилки

У деяких місцях оригінальні розробники допускали друкарські помилки під час написання коментарів. Деякі з них були помилково виправлені під час початкової оцифровки, однак оцифрування також допустило друкарські помилки, яких не було в сканованих документах.

Наприклад, якщо оцифровані коментарі містили SPAECRAFT, але SPAECRAFT було надруковано в сканах, тоді оцифрування ПОТРІБНО виправити на SPAECRAFT (відсутнє C).

Аналогічно якщо слово має друкарську помилку під час оцифрування, але написано правильно в сканах, тоді друкарську помилку ПОТРІБНО виправити.

Пробіли

Пробіли між двома символами в коментарях ПОВИННІ збігатися зі сканами. У більшості випадків (див. обговорення у #316), це:

  • Одиничний пробіл для нових слів.
  • Подвійний пробіл для нових речень.
  • Потрійний пробіл для відступів.

Не всі скановані сторінки дотримуються цього узагальнення. Якщо скани мають лише один пробіл замість подвійного, використовуйте один пробіл.

Розриви рядків

  • Розриви рядків з R0000 у стовпці 1 мають точно відповідати сканам.
  • Розриви рядків з*out* 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, будь ласка, переконайтеся, що ваші зміни узгоджуються зі сканами!