Apollo-11/CONTRIBUTING.fr.md
2020-10-04 16:47:13 +01:00

4.7 KiB
Raw Blame History

Contribuer

🎌 Čeština, Deutsch, English, Español, Français, Kurdi, Nederlands, Português, Türkçe, العربية, 日本語, 正體中文, 简体中文, 한국어

Le code source de ce dépôt a été numérisé manuellement à partir dimprimés papier, de sorte que les fautes de frappe et autres anomalies ont été introduites accidentellement. Le code doit être modifié pour être cohérent avec les impressions numérisées:

Extensions utiles

Github prend en charge nativement la syntaxe pour le langage assembleur AGC. Malheureusement, votre éditeur de texte ne laura pas. Mais il y a des extensions pour le langage AGC pour les éditeurs suivants:

† Prend en charge le formatage automatique

Mise en page

Note: GitHub et les extensions marquées ci-dessus vous assureront d'utiliser automatiquement le bon formatage.

  • Indenter avec tabulation
  • Les tabulations ont une taille de 8
  • Pas d'espace à la fin des ligne

Comment vérifier ?

Tout écart entre les scans et le code source dans ce référentiel, y compris :

Commentaires

  • Les commentaires dans le code transcrit doivent correspondre exactement aux scans
    • Cela peut impliquer de créer délibérément une erreur de frappe ou de supprimer/ajouter un commentaire entier.

Sauts de ligne

  • Les lignes avec R0000 dans la colonne 1 doivent correspondre exactement aux scans.
  • Les sauts de ligne sans R0000 dans la colonne 1 ne doivent contenir que 1 ou 2 lignes vides d'affilée.
    • Si il y a plus de 2 lignes vides, supprimer les sauts de ligne supplémentaires.
      • Ne pas prendre en compte les lignes avecc R0000 dans la cononne 1.
    • Dans les images sources, il y a digits non imprimés dans la colonne 8. Un 2 force un double espace (une seul ligne vide) et un 3 force une triple espace (double ligne vide). Les valeurs 4-8 ont été définies mais nont jamais été utilisées. Pour en savoir plus #159

Par exemple, ce qui suit:

R0819   SUBROUTINE TO SKIP...
R0820



 0821   LAMPTEST  CS  IMODES33

Doit devenir:

R0819   SUBROUTINE TO SKIP...
R0820


 0820   LAMPTEST  CS  IMODES33

Espaces

  • Les espaces entre deux caractères doivent respecter la convention suivante (voir la discussion #316):
    • Un seul espace pour un nouveau mot.
    • Deux espaces pour une nouvelle phrase.
    • Trois espaces pour l'indentations.

Par exemple, ce qui suit:

	1)  FOO BAR BAZ QUX QUUX QUUZ. CORGE, GRAULT,
	GARPLY, WALDO.

Doit devenir:

	1) FOO BAR BAZ QUX QUUX QUUZ.  CORGE, GRAULT,
	   GARPLY, WALDO.

Note

Avant de faire une PR, assurez-vous que vos modifications sont cohérentes avec les scans!