processing / processing/p5.js-website
Adding the Persian/Farsi translation to the website
Nobody has claimed this yet.
- Dominant language
- MDX
- Stars
- 96
- Forks
- 322
- Avg merge
- 5d 22h
- Merged PRs (30d)
- 8
Description
Increasing Access
The Farsi/Persian translation can help Farsi speakers who have limited knowledge of English, to better understand the documentation and educational materials on the website. This would be especially helpful for younger generations of Iranians, Afghans and Tajiks.
Integrating the Farsi lettering and RTL (right-to-left) direction would also lay the groundwork for adding Arabic in future.
Most appropriate sub-area of p5.js?
Tutorials
Feature request details
My friend Arash Ebrahimifar is doing the heavy work of the translation and editorial work, while I am helping him with complementary tasks and clarifying certain coding concepts and definitions. We may also have the assistance of other people along the process. All the texts will be reviewed by native speakers.
We have started the translation from the "Introduction to p5.js" section in Tutorials. Our strategy for preparing the translations is to start with the Tutorials and slowly add to the Reference, based on the hyperlinks or keywords that the readers might encounter through the Tutorials.
The primary issue would be the RTL layout. Especially when we want to add English texts or inline code, that text needs to remain in the right place and keep its own direction separate from the Farsi text. For example the inline functionName() need to stay in line within the Farsi paragraph while keeping its parentheses on the right-side.
Contributor guide
No contributing guide indexed for this repository
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with the website's Tutorials, especially the "Introduction to p5.js" section, and inspect how tutorial text and inline code are rendered. Done means the translated material can be added with correct Persian/Farsi RTL layout, while English text and inline code retain their intended direction; the Reference can follow later.
Written by the indexing model from the issue text.
Assessment
- Domain
- accessibility, documentation, localization
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 48/100