New tutorial

[s-makin]

Proposed Commit Message

docs: Update tutorials

- Applying extensive feedback from Daniele on our tutorials.
- Tutorials have been streamlined so that we now have a space for
alternative deployment methods (e.g. WSL) to be put under "how-to".
- Tutorials can now be kept for demonstrating features and capabilities.
- Additional tutorials can be created using the LXD quickstart as the basis

Merge type

• Squash merge using "Proposed Commit Message"
• Rebase and merge unique commits. Requires commit messages per-commit each referencing the pull request number (#<PR_NUM>)

[a-dubs]

One small nit inline, but looks good otherwise!

Cheers, @s-makin

[holmanb]

Thanks for this PR @s-makin! I haven't reviewed the change yet, however it looks like updating the spelling work caused our CI spelling test to fail. You can run the test locally with this: tox -e doc-spelling -- doc/rtd doc/rtd_html

Currently this yields:

WARNING: doc/rtd/development/style_docs.rst:93: : Spell check: copybutton: Our documentation uses the Sphinx extension “sphinx-copybutton”, which creates.
WARNING: doc/rtd/howto/run_cloud_init_locally.rst:74: : Spell check: qemu: qemu-system-<arch>.
WARNING: ../../module-docs/cc_chef/data.yaml:1: : Spell check: validator:  (string) The name of the chef-validator key that Chef Infra Client uses to access the Chef Infra Server during the initial Chef Infra Client run..
WARNING: ../../module-docs/cc_growpart/data.yaml:1: : Spell check: dev:  (array of string) The devices to resize. Each entry can either be the path to the device’s mountpoint in the filesystem or a path to the block device in ‘/dev’. Default: .
WARNING: Found 4 misspelled words

[s-makin]

Thanks for this PR @s-makin! I haven't reviewed the change yet, however it looks like updating the spelling work caused our CI spelling test to fail. You can run the test locally with this: tox -e doc-spelling -- doc/rtd doc/rtd_html

Currently this yields:

WARNING: doc/rtd/development/style_docs.rst:93: : Spell check: copybutton: Our documentation uses the Sphinx extension “sphinx-copybutton”, which creates.
WARNING: doc/rtd/howto/run_cloud_init_locally.rst:74: : Spell check: qemu: qemu-system-<arch>.
WARNING: ../../module-docs/cc_chef/data.yaml:1: : Spell check: validator:  (string) The name of the chef-validator key that Chef Infra Client uses to access the Chef Infra Server during the initial Chef Infra Client run..
WARNING: ../../module-docs/cc_growpart/data.yaml:1: : Spell check: dev:  (array of string) The devices to resize. Each entry can either be the path to the device’s mountpoint in the filesystem or a path to the block device in ‘/dev’. Default: .
WARNING: Found 4 misspelled words

Thanks, I didn't know about that - funnily enough, the CI test only showed up two of those four, while when I ran the test locally, I only got 3! Not sure what the cause of the inconsistency is, but I used your list to fix them.

[holmanb]

Thanks for this PR @s-makin! I left some comments inline.

[holmanb]

A part 1 without a part 2 feels odd. Were you planning to add more here?

[s-makin]

I am yes, but it won't be part of this PR because it's still in the early draft stage.

[s-makin]

It's been agreed that Part 2 won't be done any time soon - would you prefer me to remove the reference, or should I leave it like this as a placeholder for where any future tutorials should go?

[holmanb]

Thanks @s-makin, this looks great!

[holmanb]

@s-makin I just noticed one minor issue - after that is fixed I'm happy to merge it!