◊(Local Yarn Code "Update of "Style Guide"")

These are notes for my own use.

Prose

• The Local Yarn should be italicized.
• The Local Yarn is emphatically not “a web site”.

Punctuation

• In a list of actions, list items should end with a period.
• In a list of things, list items should not end with a period.
• Place trailing commas and periods outside of quotation marks unless they are part of the quoted text.

Source files

• Header comment includes copyright notice, license information, and author contact info.
• (Racket) All comments on their own line begin with ;;

Pre-commit checklist

1. Run fossil diff --tk to ensure all edits are related.
2. Run fossil changes --differ to ensure no extra files need to be added.
3. If any files have been added with fossil add ensure the makefile is up to date.
4. Make sure you’re on the correct branch.

Commit messages

• Commit messages should use the imperative voice.
• Commit messages should be no more than ≈ 50 characters long.
• If more explanation is needed, create a ticket and cross-reference it with the commit message.
• Comments added to tickets in connection with a resolving check-in should describe why the change was made, not how (the code does that part already).