Skip to content

Add friendly-traceback to similar projects - #149

Draft
m-aciek wants to merge 1 commit into
3.15from
friendly-traceback
Draft

Add friendly-traceback to similar projects#149
m-aciek wants to merge 1 commit into
3.15from
friendly-traceback

Conversation

@m-aciek

@m-aciek m-aciek commented Aug 27, 2026

Copy link
Copy Markdown
Collaborator

friendly-traceback contains Python-related localisation. It's a utility that lowers the entrypoint barrier to Python, it's used in education.

Comment thread README.en.md
* [micro:bit translation programme](https://microbit.org/translate/)
* [Sphinx translation](https://www.sphinx-doc.org/en/master/usage/advanced/intl.html#contributing-to-sphinx-reference-translation)
* [Localizing Django](https://docs.djangoproject.com/en/dev/internals/contributing/localizing/)
* [friendly-traceback: notes on translations](https://friendly-traceback.github.io/docs/translation_notes.html)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm, I'm still not a particular fan of this, but if you want it let's put it in "useful materials".

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

In my opinion useful materials are not the place for this. Similar projects is list of other translation projects also worth investing in, where this fits just fine.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The distinction is that the other Similar projects are actual translation efforts, whereas this is a collection of notes and guidance on things like project structure, POEdit, and gettext, so Useful materials seems like the more appropriate place for it.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Friendly-traceback has rudimentary translation process, keeps PO files in repository and accepts PRs. I was meaning to link to a starting point for a potentially interested translator.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Then this isn't the page to link to, as the author puts it, it's an explanation of how to use gettext.

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

You're right, I only glossed over the article, the fact that it's located in Contribute section misled me. When at desktop, I am going to replace them link with https://github.com/friendly-traceback/friendly-traceback/tree/main/friendly_traceback%2Flocales directly, because of lack of better alternative.

@m-aciek m-aciek Aug 27, 2026

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Or better, improve the docs in the friendly-traceback project first.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

If there isn't a nice overview then I don't think we should link to it. Also, the project does not seem active, the last commit was a year ago.

@m-aciek
m-aciek marked this pull request as draft August 27, 2026 17:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants