docs: update 12-factor tutorials

[erinecon]

Update the 12-factor tutorials.

Specific updates:

• Convert to reStructuredText
• Incorporate feedback from UX session with Daniele
• Update all tutorials for consistency (feedback from previous PRs, feedback from Daniele)

[lengau]

Hey Erin, I really appreciate this work! Just a note, this is going to conflict with #2083 as it also moves these files to rst. You may want to try to coordinate with @jahn-junior, though I imagine we'll be merging his PR on Monday or Tuesday.

[erinecon]

Hey Erin, I really appreciate this work! Just a note, this is going to conflict with #2083 as it also moves these files to rst. You may want to try to coordinate with @jahn-junior, though I imagine we'll be merging his PR on Monday or Tuesday.

Hi @lengau, thanks for letting me know about the other PR. I was under the impression that the 12-factor docs weren't going to be touched since we had planned work to refactor them (See this comment on PR #2010 ). I see there's also #2048 with the how-to guide that I'm planning on refactoring, but that's for a later PR, so I will hold off on that work until after the PR has been merged.

It seems unfortunately that any changes to the Django tutorial might be overwritten by the work in this PR, but I will not touch the FastAPI or Go tutorials until after #2083 has been merged. Thanks again for letting me know.

[lengau]

Hey @erinecon !

On #2048: I'm happy for you to take over that one or to close it unmerged if you want to redo the MD -> rST conversion in your own PR, or we can work together to prioritise the completion so it won't affect you.

Hopefully you should be able to rebase this PR either on #2083 or on main once it's merged and not have too many conflicts.

[erinecon]

Hi @lengau , thanks for the offer. I'm fine with waiting for #2048 to be merged before working on a new PR. I appreciate the work you're all doing to convert the files to rST, it saves me a bunch of time! :)

[lengau]

Thanks for your patience @erinecon ! I've just merged #2083 to main, introducing the conflicts :-)

[erinecon]

Thanks @lengau for the update!! I'll get started on resolving the conflicts and making the rest of the planned updates shortly :)

(I'll also turn off the spread tests before marking the PR as ready for review.)