docs: translate remaining .md files to .rst

[jahn-junior]

Translated remaining Markdown files from #2010 to reStructuredText.

The contents of each page remain largely unchanged, with the main exceptions being:

• Dropdowns in Manage a 12-factor app charm were replaced with tabs.
• Output of juju status in tutorials was changed from a bash code directive to a terminal directive.

[lengau]

Thanks for doing this!

My comments are a combination of specific requests and general observations, some of which may be better for a separate task.

[lengau]

Is this maybe a better destination for the link?

[lengau]

Suggested change

	Follow this `how-to guide <https://documentation.ubuntu.com/rockcraft/en/latest/how-to/build-a-12-factor-app-rock>`_
	Follow this :external+rockcraft:doc:`how-to guide <how-to/build-a-12-factor-app-rock>`

[lengau]

Suggested change

	The key optional with value ``False`` means that the charm will
	The key ``optional`` with value ``False`` means that the charm will

[lengau]

Suggested change

	:literalref:`rockcraft.yaml <https://documentation.ubuntu.com/rockcraft/en/stable/reference/rockcraft.yaml/#services>`_
	:literalref:`rockcraft.yaml <https://documentation.ubuntu.com/rockcraft/en/stable/reference/rockcraft.yaml/#services>`

This is subtle, but :literalref: is part of canonical-sphinx-extensions, so it messes up if you have the underscore afterwards. You'll get a warning during the build that looks something like this:

/home/lengau/Work/Code/charmcraft/docs/reference/extensions/fastapi-framework-extension.rst:215: WARNING: Mismatch: both interpreted text role prefix and reference suffix.

[lengau]

Suggested change

	file, but additional changes are then required to enable the charm to be
	built with Charmcraft.
	file, but additional changes are then required to build the charm with Charmcraft.

[lengau]

Not all profiles generate this file.

[medubelko]

Let's change it to "profiles other than the one for 12-factor apps automatically create..."

[lengau]

Same here - not all profiles generate this file. I think specifically the 12-factor ones don't.

[lengau]

Suggested change

	curl 10.1.157:8000
	curl 10.1.157.80:8000

[medubelko]

We'll need to:

• Fix all the indentation for the YAML code blocks; it needs to be based on two spaces or it won't render correctly.
• Fix outstanding lint errors.

[medubelko]

Suggested change

	``Other keys``
	--------------
	Other keys
	----------

[medubelko]

Suggested change

	incorporated into CI processes. An example is
	:literalref:`upstream source <https://github.com/canonical/charmcraft/blob/b22fcdba3b894004468abfbf45caa54d93fbf7d0/charmcraft/templates/init-simple/metadata.yaml.j2#L40-L43>`_.
	incorporated into CI processes.

Let's cut this, because it isn't appropriate to provide such a specific example for an open-ended syntax.