Re: Move legacy info for install/windows
| From: | Christoph Becker | Date: | Fri, 25 Mar 2016 10:16:23 +0000 |
| Subject: | Re: Move legacy info for install/windows | ||
| References: | 1 2 3 | Groups: | php.doc |
| Request: | Send a blank email to phpdoc+get-969386065@lists.php.net to get a copy of this message | ||
On 24.03.2016 at 21:17, Matt Ficken wrote:
> I can update win32/install.txt in php-src. Good point.
>
> Good point about other languages too. Same outdated info for
> install/windows is in all languages and eventually should be updated.
>
> I can't update that document in all languages(just en, and maybe es or fr).
>
> For now, can we move just the
en copy of install/windows to
> install/windows/legacy ? Then I can update that document
>
> Then, when others are ready to do the translation, they can update it for
> de, ru, etc...
I'm note sure whether this is a good idea. Moving the en docs to a new
folder and updating the old docs in place will cause additional
translation work, if the translators are not aware of this change. The
doc system[1] will report the install/windows/*.xml docs to be
out-dated, so a translator would have to update them (what has to be
done anyway – no problem here). However, the doc system will also tag
the install/windows/legacy/*.xml docs as new files, and a translator
might translate them *anew* (not being aware that those files only had
moved).
The best solution with regard to translations would be to *copy* all
files under install/windows/ to the new folder. This way only those
files that really will change will be tagged as being out-dated in the
other languages.
Anyhow, I have created en/install/windows/legacy/ right now.
[1] <http://doc.php.net/> and <https://edit.php.net/>
--
Christoph M. Becker