Gnome docs update before Beta 2?

[David Planella]

El dt 12 de 04 de 2011 a les 12:25 +0100, en/na Matthew East va
escriure:
> On 12 April 2011 10:41, David Planella <david.planella at ubuntu.com> wrote:
> > El dt 12 de 04 de 2011 a les 07:33 +0000, en/na Matthew East va
> > escriure:
> >> Another issue is what to do with ubuntu-docs. At present it is pretty
> >> useless on the CD as it isn't shown by yelp. However at the same time
> >> it is used by at least two applications that I can think of for help
> >> (jockey and usb-creator). If we are to drop ubuntu-docs we need to
> >> either include that help in the applications themselves, include the
> >> help in gnome-user-docs and update the applications accordingly, ship
> >> a slimmed down version of ubuntu-docs with just those documents, or
> >> leave it as it is.
> >
> > I'd be up for moving the application-specific documentation to the
> > applications themselves and leave out ubuntu-docs. This means though,
> > adding support to the application packages (jockey and usb-creator) for
> > building the translations.
> 
> Yes, I think that is the "proper" solution. I suppose that in terms of
> support the gnome build environment could be reused, but I'm not
> familiar enough with it nor will I have enough spare time over the
> next few days to work on this. If we can't get this done, I think the
> solution is to ship a slimmed down version of ubuntu-docs with just
> those documents.
> 

Thanks Matthew for the quick reply.

Hm, I'm not sure we'll be able to reuse the usual GNOME build system for
those, as GNOME uses gnome-doc-utils + autotools, which will not be easy
to adapt to the Python + python-distutils-extra setup of jockey and
usb-creator.

I created a branch to build translated docs for jockey a while ago, so
while I'll try to dig that out and see if it is still usable, I think
we're running out of time.

Thinking again, I believe and that the easiest thing for this cycle, in
this particular case, will be the second option: shipping a slimmed-down
version of ubuntu-docs with the jockey and usb-creator docs.

As per the rest of the documentation, I also agree that due to the time
constraints it might not be possible to ship the translations, only a
modified version of the gnome user guide, but it would be great to do
some post-release updates to pick up translations.

Cheers,
David.

-- 
David Planella
Ubuntu Translations Coordinator
www.ubuntu.com / www.davidplanella.wordpress.com
www.identi.ca/dplanella / www.twitter.com/dplanella
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 490 bytes
Desc: This is a digitally signed message part
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20110412/ff682347/attachment.pgp>