- Start Date: (fill me in with today's date, YYYY-MM-DD)
- RFC Issue: (fill me in)
- RFC PR: (leave this empty)
- Implementation Issue: (leave this empty)
One para explanation of the guideline.
This should get into specifics and corner-cases, and include examples of code which satisfies and violates the guideline, and it interacts with other formatting guidelines.
Guidelines may include more than one acceptable rule, but should offer guidance for when to use each rule (guidance which should be formal enough to be used by Rustfmt).
This should specify how Rustfmt options must be set to enforce the guideline, and what further changes (including additional options) are required. It should specify any renaming, reorganisation, or removal of options.
This should motivate the choices behind the guideline. It should reference existing code bases which use the proposed style.
What other designs have been considered?
What parts of the design are still TBD?