Simplify README and transfer content, also new content Spin/Bart using website template

[tpmccallum]

This is a PR which is the beginning of creating a single source of truth for the Bartholomew docs.
Essentially, remove content from the readme.md file and place that content in the official docs (in the relevant spots/files).
Also updated the documentation to reflect that Spin exclusively creates a new site (and can do so using a template) and that Bart will no longer be performing this sort of task.

The initiative for this change
The conversation about the idea to simplify the README.md can be found here.

The tests in relation to this change

Preview
spin up -e "PREVIEW_MODE=1"

Bart check
bart check

Signed-off-by: tpmccallum mistermac2008@gmail.com

[mikkelhegn]

There's a single "bug" around the bartholomew spin template which should be fixed. Everything else is just feedback and not blocking.

[tpmccallum]

Awesome feedback, thank you @mikkelhegn
I will attend to all of these, much appreciated.

The spin templates install bug is interesting, I will look into that; not sure why that is happening.

[itowlson]

There's no spin templates install bug here - the site template is a GitHub template (for GH repos), not a Spin application/component template. It's correct that Spin finds no Spin templates in the GH repo template.

[itowlson]

(There is of course no reason we couldn't create a Spin template for a Bartholomew web site. But this isn't that.)

[tpmccallum]

Thank you Ivan @itowlson
Given that the bartholomew-website-template is not a Spin application/component template I will just go ahead and clone the template and then run Spin commands from within.

[itowlson]

People creating sites would not clone the template I think - they would use the template to create a new repo.

https://docs.github.com/en/repositories/creating-and-managing-repositories/creating-a-repository-from-a-template

(obviously if the article is about working on the template itself then yes, fork and clone)

[tpmccallum]

Hi @mikkelhegn and @itowlson
Thanks a million for your suggestions, all great. Keen eyes!
These have all been resolved in the 47adbae commit.
Thanks
Tim

[tpmccallum]

Please note, that those changes have been actioned in the last few commits.
Thanks again and happy for more feedback also. Very helpful.

[mikkelhegn]

Looks like the .DS_Store files are now checked-in, in a few places?

Changes I asked for are done, but don't feel confident to approve

[tpmccallum]

Thanks @radu-matei glad to wrap this one up.
Thanks, @itowlson @mikkelhegn @karthik2804 that was a good amount of reviewing; much appreciated.