Re: Proposal to start Persian (Farsi) PHP Manual translation

--000000000000c679a60653b5d5bc
Content-Type: text/plain; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

On Sun, Jun 7, 2026, 12:58=E2=80=AFPM MOSTAFA SHARIATZADEH <shrytzadh@gmail=
.com>
wrote:

>
> Hello,
>
> I have successfully subscribed to the phpdoc mailing list.
>
> I would like to propose starting a Persian (Farsi) translation project fo=
r
> the PHP Manual.
>
> As far as I know, there is currently no active Persian translation team o=
r
> repository. I would like to contribute to initiating and maintaining it.
>
> Could you please guide me on the required steps to:
> - create or join a doc-fa translation team (if it exists or can be create=
d)
> - set up the translation workflow and repository
> - begin contributing translations
>
> I am ready to start with small sections such as "Getting Started" and
> gradually expand.
>
> Thank you for your support.
>

Hi there!

There has been a previous request for a Farsi translation. Christoph (cmb)
provided an excellent answer in response that I'm copying/pasting below the
double dashes (--).

Aside from that, the previous person who requested the Farsi translation
had started their own attempt at <https://github.com/elamirch/doc-fa>, but
it appears that it's no longer maintained. Maybe this can be of help to you
as a starting point?

--

Note that trying to tackle a new translation is a lot of work (really!),
and while there is <https://svn.php.net/viewvc/phpdoc/fa/>, this is likely
so outdated that this would be like a new translation.  I suggest that you
create a new translation repository as a fork of <
https://github.com/php/doc-en> (there is no *need* to have your repo on
Github), and then start with the translation, trying to get other
contributors interested in this to help.  When you get to the point where
at least the most relevant pages (maybe around 10%) have been translated to
Farsi, write to the list so that the repository can be moved to <
https://github.com/php/doc-fa> and integrated to the PHP manual.  Note
though, that an initial translation needs to be maintained; mostly kept up
to date, but also extended with new page translations.

>

--000000000000c679a60653b5d5bc
Content-Type: text/html; charset="UTF-8"
Content-Transfer-Encoding: quoted-printable

<div dir=3D"auto"><div><div class=3D"gmail_quote gmail_quote_container"><di=
v dir=3D"ltr" class=3D"gmail_attr">On Sun, Jun 7, 2026, 12:58=E2=80=AFPM MO=
STAFA SHARIATZADEH &lt;<a href=3D"mailto:[email protected]">shrytzadh@gma=
il.com</a>&gt; wrote:<br></div><blockquote class=3D"gmail_quote" style=3D"m=
argin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir=3D"r=
tl"><br>Hello,<br><br>I have successfully subscribed to the phpdoc mailing =
list.<br><br>I would like to propose starting a Persian (Farsi) translation=
 project for the PHP Manual.<br><br>As far as I know, there is currently no=
 active Persian translation team or repository. I would like to contribute =
to initiating and maintaining it.<br><br>Could you please guide me on the r=
equired steps to:<br>- create or join a doc-fa translation team (if it exis=
ts or can be created)<br>- set up the translation workflow and repository<b=
r>- begin contributing translations<br><br>I am ready to start with small s=
ections such as &quot;Getting Started&quot; and gradually expand.<br><br></=
div></blockquote></div></div><div dir=3D"auto"><div class=3D"gmail_quote gm=
ail_quote_container"><blockquote class=3D"gmail_quote" style=3D"margin:0 0 =
0 .8ex;border-left:1px #ccc solid;padding-left:1ex"><div dir=3D"rtl">Thank =
you for your support.</div></blockquote></div></div><div dir=3D"auto"><br><=
/div><div dir=3D"auto"><div dir=3D"auto">Hi there!=C2=A0</div><div dir=3D"a=
uto"><br></div><div dir=3D"auto">There has been a previous request for a Fa=
rsi translation. Christoph (cmb) provided an excellent answer in response t=
hat I&#39;m copying/pasting below the double dashes (--).</div><div dir=3D"=
auto"><br></div><div dir=3D"auto">Aside from that, the previous person who =
requested the Farsi translation had started their own attempt at &lt;<a hre=
f=3D"https://github.com/elamirch/doc-fa">https://github.com/elamirch/doc-fa=
</a>&gt;, but it appears that it&#39;s no longer maintained. Maybe this can=
 be of help to you as a starting point?</div><div dir=3D"auto"><br></div><d=
iv dir=3D"auto"></div><div dir=3D"auto">--</div><div dir=3D"auto"><br></div=
><div dir=3D"auto">Note that trying to tackle a new translation is a lot of=
 work (really!), and while there is &lt;<a href=3D"https://svn.php.net/view=
vc/phpdoc/fa/">https://svn.php.net/viewvc/phpdoc/fa/</a>&gt;, this is likel=
y so outdated that this would be like a new translation.=C2=A0 I suggest th=
at you create a new translation repository as a fork of &lt;<a href=3D"http=
s://github.com/php/doc-en">https://github.com/php/doc-en</a>&gt; (there is =
no *need* to have your repo on Github), and then start with the translation=
, trying to get other contributors interested in this to help.=C2=A0 When y=
ou get to the point where at least the most relevant pages (maybe around 10=
%) have been translated to Farsi, write to the list so that the repository =
can be moved to &lt;<a href=3D"https://github.com/php/doc-fa">https://githu=
b.com/php/doc-fa</a>&gt; and integrated to the PHP manual.=C2=A0 Note thoug=
h, that an initial translation needs to be maintained; mostly kept up to da=
te, but also extended with new page translations.</div></div><div dir=3D"au=
to"><div class=3D"gmail_quote gmail_quote_container"><blockquote class=3D"g=
mail_quote" style=3D"margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-l=
eft:1ex">
</blockquote></div></div></div>

--000000000000c679a60653b5d5bc--