Reworked README & supplimenting docs

[piercemorris]

Part of this issue.

This can be opinionated but essentially I've moved any large sections to its own documentation, and tried to keep the README slim. I've kept content changes minimal and didn't visit the FAQ section so any comments regarding that would be helpful.

Anything else that can be removed/updated/added revolving the docs I can add it into here no problem!

[github-actions]

✔️ No visual differences introduced by this PR.

View Playwright Report (note: open the "playwright-report" artifact)

[piercemorris]

@djahandarie @toasted-nutbread do these changes look good to you?

[toasted-nutbread]

Can you add newlines to the end of the files that don't have it? A lot of people have settings which auto-format with an empty newline at the end on save which can cause unnecessary git diffs when those are added. (That's probably something that should be a configuration thing for the project settings.)

[MarvNC]

Can you add newlines to the end of the files that don't have it? A lot of people have settings which auto-format with an empty newline at the end on save which can cause unnecessary git diffs when those are added. (That's probably something that should be a configuration thing for the project settings.)

Maybe prettier? It could also make line breaking more consistent if you enable the proseWrap option.

[piercemorris]

Can you add newlines to the end of the files that don't have it? A lot of people have settings which auto-format with an empty newline at the end on save which can cause unnecessary git diffs when those are added. (That's probably something that should be a configuration thing for the project settings.)

Adding to what @MarvNC mentioned, I feel like prettier would solve this issue rather than adhoc comments on the PRs - #517. I will make the amendments as you suggested.

[djahandarie]

I'm a little skeptical that the subpages will be visible enough for people, I feel like they might get missed when someone is looking for some piece of information. But we can give it a shot. Just left one comment, okay to approve after that.