Re: documentation bugs for packages
| From: | Moosh | Date: | Sun, 08 Jan 2006 16:12:26 +0000 |
| Subject: | Re: documentation bugs for packages | ||
| References: | 1 2 | Groups: | php.pear.doc |
| Request: | Send a blank email to pear-doc+get-7430@lists.php.net to get a copy of this message | ||
Martin Jansen wrote:
> On Sun Jan 08, 2006 at 12:4023PM +0100, Lukas Smith wrote:
>>I am wondering if it makes sense to re-assign all doc bugs on specific
>>packages on the default english manual to the relevant package. I think
>>this would increase visibility for the maintainer (especially if there
>>are multiple maintainers).
>
>
> Sounds like a good idea.
It's difficult to do that directly in bug track form ?
By adding "online-documentation" as new "BUG TYPE"
In the same idea I think that "sample", "in pack doc" and "Tests" can
be also types.
and add a highlighted message to say that
http://pear.php.net/bugs/report.php?package=Documentation
is for
general problem in manual ?
perhaps also a subtype to say if it's a translation or original content
problem.
Finally a last remark
"Bug Type" is misnamed because "Bug" is one of type.
"Bug Type" would be renamed to something like "feedback type".
But following this. perhaps
"Feedback type" have only 2 types to propose "bug" or "suggestion"
and there miss a list of subtopic which proposed what's target in the
package for the current feedback.
With as proposed list
* "code"
* "manifest"
* "on line doc"
* "sample"
* "in pack doc"
* "Tests"
I my English give problem I can repeat in French.
--
---------------------------------
Moosh -- claroline.net -- php.net
=== Php & Pear @ Fosdem 2006 ===
http://moosh.et.son.brol.be/ (fr)