Documentation Updates [AARD-2027]

[azaleacolburn]

Task

AARD-2027

Symptom

Much of our documentation was out of date, unhelpful, or just poorly written.

Solution

This PR revises, rewrites, reformats nearly all of the documentation files in Synthesis. The goal of this PR is not to comprehensively document all of Synthesis—that should be done peace-meal—rather merely to make the documentation we have more accurate, readable, and robust.

Verification

• No spelling/grammar mistakes
• Documentation is accurate
• Documentation is well-written and direct.

---

Before merging, ensure the following criteria are met:

• All acceptance criteria outlined in the ticket are met.
• Necessary test cases have been added and updated.
• A feature toggle or safe disable path has been added (if applicable).
• User-facing polish:
  • Ask: "Is this ready-looking?"
• Cross-linking between Jira and GitHub:
  • PR links to the relevant Jira issue.
  • Jira ticket has a comment referencing this PR.

[AlexD717]

Couple of minor grammar stuff

[rutmanz]

It looks like a few things (like contact info) are duplicated across CONTRIBUTING.md and README.md (and say different things)

[rutmanz]

wdym mostly

[azaleacolburn]

I didn't write that, it was copy-pasted from the old fission readme, I'm not sure what Hunter meant by "mostly" either.

[rutmanz]

if you're going to say mostly specify the exception imo

[azaleacolburn]

I agree, I'll need to look into the simulation system to figure out what he meant

[rutmanz]

wrong button

[ryanzhangofficial]

Looks great! Just clarify the parts with "mostly" and it should be good to go.

[AlexD717]

Couple more grammar issues

[BrandonPacewic]

Some outright gammer changes that need to be made. Left one suggestion with a justification, feel free to make that edit or not.