Apollo-11/CONTRIBUTING.no.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

5.5 KiB
Raw Blame History

Bidra

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

Kilde koden I dette «repository» var digitalisert manuelt ifra papir utskrifter, om det finnes stavefeil og andre avvik skall koden reflektere dette. Skrivefeil og andre avvik kan ha blitt innført ved et uhell men skal allikevel være identisk med følgende digitalisert papir utskrifter:

Nytteprogrammer

GitHub har kildekode støtte for «assembly» programmerings språket AGC ( innebygget ), og de følgene tekst redigerings programmene har også støtte for nøkkel ord fargesetting:

† Supporterer automatisk formattering

Formattering

Merk: GitHub og redigerings programmene nevnt ovenfor vil sørge for at du bruker korrekt formattering av kilde koden.

  • Bruk Tab for innrykk
  • Bruk Tab med 8 mellomrom
  • Ta bort mellomrom og annet som ikke er synlig på slutten av setninger

Hva må jeg sjekke?

Eventuelle avvik ifra de innskannede bildene og kilde koden i dette «repository»

Kommentarer

Kommentarer i denne koden SKAL stemme eksakt med den digitaliserte originalen.

Vanlige feil en bør se etter er blant annet:

Typografiske feil

Noen steder skrev original utvikleren feil i kode kommentarene. Noen av disse feilene ble rettet under digitaliseringen, og digitaliseringen har også introdusert nye typografiske feil som ikke kommer ifra papir utskriften.

For eksempel, om de originale dokumentene var feilstavet til SPAECRAFT og de digitaliserte dokumentene ble endret til SPACECRAFTSKAL dette rettes til og reflektere de originale dokumentene, altså uten C i ordet.

På samme måte, om digitaliseringen introduserte stavefeil som ikke var tilstede i de originale dokumentene SKAL dette rettes.

Mellomrom

Mellomrom mellom to karakterer i teksten BØR følge de digitaliserte dokumentene. I de fleste tilfeller (se diskusjon i [#31610) betyr dette:

  • Enkelt mellomrom for nye ord
  • Dobbelt mellomrom for nye linjer
  • Trippel mellomrom for innrykk

Ikke alle sider i de digitaliserte dokumentene følger denne generaliseringen, så om de digitaliserte dokumentene bruker enkelt mellomrom i stedet for dobbelt mellomrom så skal enkelt mellomrom følges.

Linje Skift

  • Linje skift med R0000 i kolonne 1 skal stemme helt med originalen.
  • Linje skift uten R0000 i kolonne 1 skal bare ha en eller to blanke linjer etter seg.
    • Om det er flere enn to blanke linjer skal de fjernes
      • Linjer med R0000 i kolonne 1 regnes ikke i slike tilfeller
    • I originalen ble disse skapt av et uskrevet tegn i kolonne 8. Sto det 2 der var der et dobbelt mellomrom ( enkel blank linje ) og om det var 3 så ble det et trippel mellomrom ( to dobble linjer ). Verdiene ifra 4 til 8 var definert, men er ikke i bruk. Les mer om dette i #159

For eksempel skal følgende kode:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Se slik ut:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Noter

Før en gjør en «Pull Request» bør man være helt sikker på at forandringer er helt lik de digitaliserte bildene!