On 08/06/2026 3:09 pm, MOSTAFA SHARIATZADEH wrote:
my github:
GitHub - m-shariatzadeh/doc-fa: Persian (Farsi) PHP documentation · GitHub <https://github.com/m- shariatzadeh/doc-fa>
MOSTAFA SHARIATZADEH <shrytzadh@gmail.com <mailto:shrytzadh@gmail.com>> در تاریخ دوشنبه ۸ ژوئن ۲۰۲۶ ساعت ۱۶:۳۸ نوشت:
Hello PHP Documentation Team,
I have completed the translation of the “Introduction” page into
Persian (Farsi).
Before proceeding with translating the rest of the documentation, I
would appreciate a quick confirmation that the current structure and
format of the translation are acceptable from your side.
Since the content is in a right-to-left language, I have adapted the
text accordingly to ensure proper display of both Persian and
embedded English terms within the page. I want to make sure that
this RTL layout does not cause any rendering or formatting issues on
the PHP documentation website.
This is purely a request for confirmation so I can continue
translating the remaining sections with confidence that the approach
is correct.
Thank you for your time and support.
Best regards,
Mostafa
------------------------------------------------------------------------
Hi Mustafa,
The current structure (for what I can judge) seems fine. Though a few notes I would like to point out to help you get started. I do not now if there will be any issues regarding RTL, but I think it shoul be fine. If not, please open an issue in GitHub - php/phd: PHD · GitHub.
At the start of each file you will see a revision. [1] & [2]
Every translated file will have one, and it is used to keep track of the status of each document. Not just if it is translated, but also if it is up-to-date. You can generate the hash through `git log`. Which you can read more about in the translation guide. [3]
Files that are not translated, should *not* exist in the translation repo. So the important thing to do is, when you translated. Add them. Otherwise leave them out of the repo. Which will make it easier for you to manage the repo. But it will also allow the for an automatic fallback to english for non translated files. For that you can look at the structure guide [4].
When you get to a point where the most relevant files have been translated, you can write to the mailing list again. It will then allow the repo to be moved into the PHP Organization, included in the manual as active translation.
For now I would like to thank you for your interest in translating the docs. If you have any further questions, feel free to ask here over the mailing list. There is also a Discord channel dedicated to docs in the PHP Community [5].
References:
[1] doc-fr/chapters/intro.xml at master · php/doc-fr · GitHub
[2] doc-fa/chapters/intro.xml at abff24f238d2c1c9483fe197e211e2c738e2c62d · m-shariatzadeh/doc-fa · GitHub
[3] PHP: Documentation Tools
[4] PHP: Documentation Tools
[5] Discord
--
Regards,
Jordi Kroon