New Read the Docs tutorial, part III (and finale?)

[astrojuanlu]

This is the third (and last? at least for now) pull request for the new Read the Docs tutorial proposed in #8106 in the context of the CZI grant. It is a follow up to #8428 and #8473.

This pull request intends to cover these chapters of the table of contents originally proposed in #8106:

5. Getting insights from your projects
   • Move around the project, explore results in Traffic Analytics
   • Play around with server-side search, explore results in Search Analytics
6. Managing translations
7. Where to go from here
   • Reference our existing guides, prominent projects already using RTD, domain configuration, our support form, our contributing documentation

I skipped the Translations part since we are ourselves figuring out what the best workflow could be, among all the possible options. We should probably refresh our translations guide instead.

[ericholscher]

This looks good! I think the only key changes are what Santos mentioned.

I'd also love to find ways to interlink the tutorial content with out feature pages. It feels like some of this content would be useful on the pages around the various analytics features.

[astrojuanlu]

Thanks @ericholscher and @stsewd for the review, I addressed the comments.

[astrojuanlu]

Rendered version: https://docs--8605.org.readthedocs.build/en/8605/tutorial/index.html

[Daltz333]

In regards to translations, frc-docs has developed a pretty decent workflow at https://github.com/wpilibsuite/frc-docs-translations

These translations are fully automatic and us maintainers require no work.

[humitos]

We should probably update this part https://docs--8605.org.readthedocs.build/en/8605/tutorial/index.html#upgrading-the-python-version to use build.os and build.tools.python instead.

[humitos]

Unrelated to this PR, using :ref: to custom .. _references makes tooltips to be empty:

• tooltip link:

  readthedocs.org/docs/tutorial/index.rst

  Line 302 in 458ed61

  by :ref:`making some decisions on your behalf <default-versions>`.

• custom reference:

  readthedocs.org/docs/builds.rst

  Line 105 in 458ed61

  .. _default-versions:

• empty tooltip: https://docs--8605.org.readthedocs.build/en/8605/tutorial/index.html#customizing-the-build-process

There is not too much that EmbedAPI can do because the id= that Sphinx generates has no content :/

[astrojuanlu]

Thanks @Daltz333! I think we should have a closer look at your procedure. We have several scattered conversations about translations here (#810, #4462, #4463) and we have been talking internally about revamping our workflow. I left a comment in the last one to keep track of your suggestion, although we will leave translations out of the tutorial for now.

[astrojuanlu]

Addressed all the feedback 👍🏽 Ready for another round

[ericholscher]

This looks good to me with a couple nitpicks. I'd love to get it shipped today, so I might merge my suggestions & the PR to get it out.

[ericholscher]

💯