Apollo-11/CONTRIBUTING.md
2017-02-14 00:10:18 +00:00

1.8 KiB

Contributing

What do I check?

Comments

  • Comments in the transcribed code should match 1:1 with the respective image.
    • This could involve creating a deliberate typo or removing/adding an entire comment.

Line breaks

  • Line breaks with R0000 in column 1 should match 1:1.
  • Line breaks without R0000 in column 1 should contain only 1 or 2 blank lines in a row.
    • Lines with R0000 in column 1 do not count towards this.
    • If there are more than 2 blank lines breaks, strip the extra line breaks.
    • In the source images, these were created by an unprinted digit in column 8. A 2 there forced a double space (single blank line) and a 3 forced a triple space (double blank line). Values 4-8 were defined but never used. Read more about it in chrislgarry/Apollo-11/#159

Formatting

GitHub, AGC Assembly for Sublime Text 3 and Language AGC for Atom will ensure you're using the correct formatting automatically.

AGC Assembly for Visual Studio Code provides language-specific settings overrides to add to your user settings here.

  • Use tab indentation
  • Use tab width of 8
  • Trim trailing whitespace

Useful Extensions

GitHub has syntax support for the AGC assembly language built-in. Unfortunately your code editor will not. Luckily there is a language extension that provides syntax highlighting for the following editors: