[Merge] lp:~nhandler/ubuntu-doc/packaging-guides into lp:ubuntu-doc

[Matthew East]

On Sun, Apr 19, 2009 at 7:15 PM, Nathan Handler <nhandler at ubuntu.com> wrote:
> I am not disagreeing that it is easier to maintain the documentation
> on the wiki. However, an internet connection is required to access the
> wiki documentation. By packaging it, the documentation would be
> available whenever it is needed. I understand that most of the other
> development-related documentation is on the wiki. However, the same
> thing could be said about normal documentation (which is spread
> between help.ubuntu.com, help.ubuntu.com/community, and
> wiki.ubuntu.com).

Well, user documentation on help.ubuntu.com is included there mainly
because plenty of users go straight to the internet for their
documentation, and don't look in the system help brower. Also, we have
a lot of material in the wiki which is only on the website, and not in
the package. So I don't think it's a fair comparison.

I think the development team should weigh up the pros and cons and
figure out which process it wants to follow.

As far as I can see, there are extremely compelling reasons for having
the primary version of the packaging guide in the wiki.

They are discussed here:

https://lists.ubuntu.com/archives/ubuntu-doc/2007-September/009378.html

That doesn't mean that if someone wants to do the work, and turn the
packaging guide into docbook once a release (via moin->docbook or
whatever tool works best), then it's a bad idea. It would not
necessarily be up to date, but if the -dev team think it would be
useful, then it can definitely be done. I think we should defer to
them for the decision, though.

> I personally do not care if
> this is part of the ubuntu-docs binary package, but I thin it would
> make sense to keep it in the same source package.

I'm not sure. The people that will contribute to the packaging guide
are members of ubuntu-dev, not ubuntu-core-doc. On that basis it
should be in a bzr branch to which ubuntu-dev has write access, I
would have thought. What are the reason you think it would help to
have a single source package with ubuntu-docs if this goes ahead?

-- 
Matthew East
http://www.mdke.org
gnupg pub 1024D/0E6B06FF