[maemo-community] The role of the docmaster

From: Murray Cumming murrayc at murrayc.com
Date: Tue May 19 19:23:40 EEST 2009
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:

b) Direct links for important modules, such as:
(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

> 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

More information about the maemo-community mailing list