Proposal: Create product for each derivative's documentation

[Cody A.W. Somerville]

On Wed, Mar 26, 2008 at 9:38 AM, Matthew East <mdke at ubuntu.com> wrote:

> Hi,
>
> On Wed, Mar 26, 2008 at 12:01 PM, Cody A.W. Somerville
> <cody-somerville at ubuntu.com> wrote:
> > Ubuntu documentation bugs are not relevant
> > to me and I do not want to receive them but I do want to continue to
> receive
> > bugs concerning the Xubuntu documentation.
>
> Here's how I feel about this. I think that those people who are
> granted entry to the ubuntu-core-doc group and hence the rights to
> commit to each of our branches (for all derivatives) should be willing
> to receive (and fix) documentation bugs for all of those packages. In
> particular, it's not always clear when a particular bug affects one
> derivative only or more than one. In such cases we need people
> interested in all derivatives to review the bugs and triage them
> appropriately. Obviously, people will have their particular interests,
> but to me that doesn't affect the basic principle.
>
> Having said that, I don't think that it's necessary for everyone in
> the non-core documentation teams (listed here -
> https://launchpad.net/~ubuntu-doc/+members<https://launchpad.net/%7Eubuntu-doc/+members>)
> to be willing to receive
> that bugmail. If people or teams from those groups are interested,
> they can subscribe to receive such bugs on an individual or team
> basis. For example, then the xubuntu-docs group could subscribe to
> xubuntu-docs bugs only.
>
> So I'd be prepared to change the bug contact for any of our bugs to
> ubuntu-core-doc.
>
> Since you're a member of ubuntu-core-doc, then that wouldn't help your
> individual case. But I do think that if you want to continue in that
> group, you should be prepared to receive bugmail for all projects, for
> the reasons given above.


An acceptable and fair compromise would be to set a mailing list (I'd
recommend creating a new ubuntu-doc-bugs ml or something) as the e-mail
address for the ubuntu-core-doc team. This would result in the mail being
sent to the mailing list (allowing for easy filtering/sorting in gmail)
instead of each individual member.

We could then change all the bug contacts to the ubuntu-core-doc team and
the appropriate sub team.


> I'll comment on your individual proposals in turn.
>
> > Disable bug reporting on the ubuntu-doc project
>
> This will leave no place for reporting bugs on the website only or wiki...
>
> > Rename project from Ubuntu Documentation to Ubuntu Documentation Project
>
> Sounds fine to me.
>
> > Update the description of the project to to give a clear definition of
> the
> > project, emphasizing that the project is Ubuntu derivative agnostic.
>
> I think that is already clear: "Ubuntu documentation is made up of the
> onboard system documentation (shipped with Ubuntu, Kubuntu, Edubuntu
> and Xubuntu, and the online documentation site
> <https://help.ubuntu.com> (including the community maintained wiki)."


If the purpose of this team and product is to encourage collaboration
between the different derivatives, I think that should be emphasized in the
description more prominent and comprehensively. Furthermore, the first
paragraph is "Help and guides for people using Ubuntu, Kubuntu and
Edubuntu."


> > Modify the bug contacts for the ubuntu-docs, kubuntu-docs, xubuntu-docs,
> > etc. etc. packages to only have the appropriate sub-team subscribed.
>
> See my general comments above.
>
> > Brainstorm other ways in which the different sub-teams can work
> together.
>
> Always happy to do that!
>
> --
> Matthew East
> http://www.mdke.org
> gnupg pub 1024D/0E6B06FF
>

I'd also like to see us do something with the series to make them agnostic
as well.

Thanks,

Cody A.W. Somerville
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20080326/5a55a30d/attachment.html>