[maemo-community] The role of the docmaster

[From: Murray Cumming]

On Tue, 2009-05-19 at 16:35 +0200, Andre Klapper wrote:
> Am Dienstag, den 19.05.2009, 14:56 +0200 schrieb Murray Cumming:
> > 3.
> > Widely publish direct links to submit Maemo documentation bugs in
> > bugzilla without needing people to guess their way through the
> > bugs.maemo.org maze to the correct product and component.
> 
> In bugs.maemo.org there is a Development platform -> Documentation
> component that I would expect developers to file doc bugs against.
> Jarmo Tikka is the current default assignee.
> 
> On the other hand when it comes to reports about **API docs**
> (http://maemo.org/api_refs/) it's best to file them against the
> appropriate product/component because they are handled by the
> developers[1].
> 
> This makes it complicated.

And either of those is awkward to get right even if you know that.

It would help if we could have 
a) A direct link for the first one, and mention it often:
https://bugs.maemo.org/enter_bug.cgi?product=Development%
20platform&component=Documentation

and
b) Direct links for important modules, such as:
https://bugs.maemo.org/enter_bug.cgi?product=Desktop%
20platform&component=hildon-widgets
(Ignoring the fact that hildon-widgets is a confusing name for
libhildon, but that's another story with no happy ending.)

Otherwise I lose a little will to live for every link that I have to
click.

> I could add a "docs" keyword to Bugzilla and change the description of
> the Documentation component at 
> https://bugs.maemo.org/describecomponents.cgi?product=Development%20platform
> to include a "Note: Reports about API docs should be filed against the
> corresponding component plus the »docs« keyword should be added" for
> such reports, but I'm interested in other proposals how to handle this
> more successfully.
> 
> andre
> 
> [1] https://bugs.maemo.org/show_bug.cgi?id=4320#c4

If this was GNOME's bugzilla, then modules would be products not
components, so they would be easier to find and they could have
"documentation" components.
 

-- 
murrayc at murrayc.com
www.murrayc.com
www.openismus.com