goldbergyoni / nodebestpractices

:white_check_mark: The Node.js best practices list (July 2024)
https://twitter.com/nodepractices/
Creative Commons Attribution Share Alike 4.0 International
97.59k stars 9.91k forks source link

Easy to translate advice #1195

Open itabbot opened 1 year ago

itabbot commented 1 year ago

It's a great repository, no doubt. I have some suggestions that I hope will help it benefit more people.

I think it's probably best to minimize the use of .gif or videos (e.g. here>>), because it might make it difficult for the translator to start translating (e.g. there is no translation here>>), Perhaps use multiple images instead, so that the translator can at least use Photoshop to tweak the image.

If you need to draw some flow charts or mind maps, maybe use some of the popular tools to draw them, then export them to JSON or XML format and explain the tools used, so that the translator can easily import the format file into the tool for translation, like this>>

I think these are necessary for a repository of 80K+ stars ⭐, don't you think?

Perhaps add these "easily translatable format suggestions" above to the writing-Guidelines.

itabbot commented 1 year ago

Please excuse my poor English.