I have asked #GPT-4.0 to translate a news report from Dutch to German for me because I wanted to inform my family about current debates in the Netherlands. I was surprised that #ChatGPT started a #deepsearch although I had not actively selected this feature. I had vaguely heard about it but never used it before, and I am still wondering what it actually does. I will have to #readthedocs for sure! But has anyone got insights they'd like to share? Deep search sounds a lot like #energywaste to me.
I'm in a situation where an organization has a #ReadTheDocs website registered as `<project>.io` (via #NameCheap). Note that no one in this organization are experts or even practitioners of web publishing. People are realizing that the documentation site is not the best landing page and want to do two things:
1. move the documentation site to `docs.<project>.io`
2. set `<project>.io` to host the landing page built on #GitHub with links out to `<project>.io`
The question is: how the heck does one go about doing this without borking everything? It's clear that external links to the documentation would need to change, but in the meantime, I can see the following:
1. register `docs.<project>.io` and add that to the domains in #ReadTheDocs
2. set `<project>.io` as the CNAME for the GitHub site
3. add JavaScript to the 404 page that detects if the link is attempting to point to the documentation site and provide the correct redirect.
About 2 or 3 years ago, I had some brave soul step up and volunteer to convert the #Xfce #documentation over to the .rst format to publish to #readthedocs
I was busy at the time; but, I went ahead and set up the initial repos & created the workflow that would allow them to publish the docs on the platform.
IIRC, they lasted several weeks and a handful of docs before they disappeared.
It's definitely not glamorous work.
I'm seeking experiences in multi-language #documentation, e.g in #Sphinx #SphinxDoc, #MkDocs, …
What system/tool can you recommend? How do you handle contributions in case a person not speaking English (which is the 'main' language) wants to add some section?
The aim is to create docs for #tryton. Thus as a bonus we need/want multi-country docs, too. E.g. for describing country-specific taxing — where we don't need information for France in the English master neither in the German translation, but the German translation needs different parts for Germany, Austria and Switzerland. (And things get worse counting in all the countries speaking English or French.) If you have experiences with this, please share.
Like, I see the benefit of working with rye for setting up new projects and working with well-formed ones, but it's surprisingly difficult to use with #ReadTheDocs because it seems like it wants you to always do things its way and gets upset when you don't.
Okay, #python people, how does one get #rye to work well with #ReadTheDocs?
I'm having a bear of a time because rye complains any time I try to do `rye init` because pyproject.toml exists, but then it complains when I try `rye sync` that it could not write the production lock file....
I just want a `.venv/` folder so that I can run `pip -m install -r docs/requirements.txt` and the python with my #Mac is 3.9, but the project requires 3.10 at least 
So any time I try to build a #ReadTheDocs site locally, I keep getting template errors from #Sphinx. Many of the solutions say "just install the theme manually and it will work," but this is not the case for me.
Anybody have any tips?
https://github.com/readthedocs-examples/example-sphinx-basic/issues/7
@awoodsnet It’s hosted on #ReadTheDocs, using their docs template and Sphinx to generate them.
The README in my docs folder goes into more detail: https://github.com/ramsey/uuid/tree/4.x/docs
Part 10: Turns out yesterday was a Reading Day. I have the libraries up and running, but it’s time to truly get the picture as to why USD is even a thing, and what made Apple choose it. A lot of the existing literature is for VFX folks, which I am not, so in addition to my Top Pick references there’s some added color for programmers.
https://www.whynotestflight.com/excuses/hello-usd-part-10-reading-day/
If you watch nothing else (39 min): https://www.nvidia.com/en-us/on-demand/session/gtcspring23-s52054/
Hartmut Goebel 
