Re: Two features needed for phpdoc translation ?
| From: | Philip Olson | Date: | Wed, 17 Dec 2008 02:50:19 +0000 |
| Subject: | Re: Two features needed for phpdoc translation ? | ||
| References: | 1 | Groups: | php.doc.zh |
| Request: | Send a blank email to doc-zh+get-3112@lists.php.net to get a copy of this message | ||
> I think that the phpdoc system should have following two new features:
These are good ideas and similar ones were briefly discussed recently here:
http://markmail.org/message/topmhhzmesrw2xwa
> (1) Translation healthy tag
>
> There are always have some out-of-date translated documents in most of
> the time, but the users do not know this -- sometimes that's nothing,
> but sometimes it will mislead those totally depending on the
> translated manual。So a healthy tag to indicate whether the translated
> document is up-to-date or not is important.
This is a difficult topic. See the quoted thread above for ideas on
how to solve this problem.
> (2) Online bug-report
> Through users can report translation bug by sending an email to phpdoc
> mail list or via the bug-report system, but it's inconvenient。So how
> about add an "Report Translation Bug" at the end of each manual page?
> Just near the "Add a note" is OK. This report should directly mailing
> to phpdoc-{lang} mail list。
This shouldn't be too difficult as we could simply link each manual
page to the appropriate bugs page. Not sure how far we want to go, but
it seems like we'd want to track the page too so we'd need to update
the bugs system to allow that. As for sending out emails, not sure how
I feel about that.
On a related note, awhile ago there was some work done on an online
editor but it sorta stalled... here's a thread:
http://markmail.org/message/xchvvhk4hlvg33a3
See what you think about all of this.
Regards,
Philip