Interest in Contributing Bengali Translation to PHP Documentation

Hello PHP Documentation Team,
My name is Sajib Adhikary, and I would like to start contributing to the PHP documentation by translating it into Bengali (bn).
I have already translated the introduction chapter file: intro.xml in sajibAdhi/doc-bn: Bengali PHP documentation.
I am interested in helping with:

  • Translating existing English documentation into Bengali
  • Reviewing and improving Bengali translations over time
  • Following the official contribution workflow and quality standards
    Could you please guide me on the best next steps to get started? Specifically, I would appreciate help with:
  1. Where Bengali translation work is currently tracked
  2. The preferred workflow/tools for translation contributions
  3. Style guidelines and terminology conventions to follow
  4. How to submit patches/PRs for review
  5. Any current high-priority sections that need Bengali translation
    I am ready to continue and would be grateful for your guidance.
    Thank you for your time and for maintaining PHP documentation.
    Best regards,
    Sajib Adhikary
    GitHub username: sajibAdhi

On 09/06/2026 5:37 am, Sajib Adhikery wrote:

Hello PHP Documentation Team,
My name is Sajib Adhikary, and I would like to start contributing to the PHP documentation by translating it into Bengali (bn).

I have already translated the introduction chapter file: intro.xml <Sign in to GitHub · GitHub; in sajibAdhi/doc- bn: Bengali PHP documentation <https://github.com/sajibAdhi/doc-bn&gt;\.
I am interested in helping with:

  * Translating existing English documentation into Bengali
  * Reviewing and improving Bengali translations over time
  * Following the official contribution workflow and quality standards

Hi Sajib,

Thank you for having interest in translating the docs. Speaking from myself and certaintly on behalf of the Documentation Team we value your (future) efforts.

I have had a quick look at the repository including the translated file and I can see you followed all the instructions well.

Could you please guide me on the best next steps to get started? Specifically, I would appreciate help with:

1. Where Bengali translation work is currently tracked
2. The preferred workflow/tools for translation contributions
3. Style guidelines and terminology conventions to follow
4. How to submit patches/PRs for review
5. Any current high-priority sections that need Bengali translation

Before officially including and integrating the translation into the docs, I first suggest that you translate the most important documentation files. Which the general workflow to do so is:
  - Copy over file from doc-en
  - Apply translations
  - Update the revision at the top of the file

I think it's best to start with the basic folders, and then slowly move your way to the reference folder. Such as:
  - chapters
  - faq
  - features
  - and so on

Once you have a good set of translations, we can migrate the repository to the PHP Organisation and have it published. You will then be able to more actively track the documentation status [1]

I would also suggest to take a look at the Italian translation repo [2], as that is currently one with the least covered translations.

I would always focus on built-in features and extensions. The Third Party extensions are the least important (there is an RFC live that suggests to move them out as well).

As a last note, I sent an e-mail to the mailing list yesterday, that has some additional information that might interest you.

[1] PHP: Documentation Tools
[2] GitHub - php/doc-it: Italian translation of the PHP documentation · GitHub

I am ready to continue and would be grateful for your guidance.
Thank you for your time and for maintaining PHP documentation.

I wish you all the best. 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 [3].

[3] Discord

--
Regards,

Jordi Kroon