Update instructions for using transifex client tool

[rffontenelle]

Fixes #9767

Direct link to the changes: https://docs--10434.org.readthedocs.build/en/10434/guides/manage-translations-sphinx.html#using-transifex

---

📚 Documentation previews 📚

• User's documentation (docs): https://docs--10434.org.readthedocs.build/en/10434/

• Developer's documentation (dev): https://dev--10434.org.readthedocs.build/en/10434/

[benjaoming]

This is much needed!! Awesome work 🤩

I don't know if you've seen, but it seems that the Sphinx documentation also hasn't been updated.

https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#using-transifex-service-for-team-translation

I have a couple of questions, but I think we should fast-forward this so adjustments can come in from active usage.

Have you tested that the steps work out in practice?

[rffontenelle]

This is much needed!! Awesome work star_struck

You're welcome, I'm glad to be able to help!

I don't know if you've seen, but it seems that the Sphinx documentation also hasn't been updated.

https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#using-transifex-service-for-team-translation

As I mentioned in a sub-thread here, thanks for pointing out that Sphinx documentation needs attention. I'll fix it later as well.

I have a couple of questions, but I think we should fast-forward this so adjustments can come in from active usage.

Fire away. Maybe a doubt you have can be an improvement to this documentation.

Have you tested that the steps work out in practice?

I use similar workflow to update the source strings of Python documentation's translation projects in Transifex (see GitHub Action workflow file). I don't use sphinx-intl update to build POT files because of particularities, but I've tested this part locally.

[benjaoming]

This is a super welcome change. Great work @rffontenelle 👏

Read the Docs also uses Transifex, so I can guarantee someone will benefit from this update 💯

CC: @agjohnson