RFC: TopicBasedHelp specification

[Brett Meadors]

Hi,
I also read through this and have to agree.  The changing of how
documentation is done could be a little troublesome.  You dont want to have
people confused working on one thing and then having a different standard on
working the same thing.   Do you really want to change the standard for one
and not for the other?

Brett
On 11/10/06, Jonathan Jesse <jjesse at iserv.net> wrote:
>
>
> > Andreas Lloyd and I have found some time at UDS for a mini-BoF to write
> > up the TopicBasedHelp specification.
> > <https://wiki.ubuntu.com/TopicBasedHelp>
> >
> > If anyone wants to comment on it in the next few hours, please do so on
> > the wiki page.
> >
> > Sorry for the short notice, but I wasn't expecting to get time to
> > discuss this subject at UDS at all.
> >
> > Cheers
> > --
> > Matthew Paul Thomas
> > http://mpt.net.nz/
> >
> > --
> > ubuntu-doc mailing list
> > ubuntu-doc at lists.ubuntu.com
> > https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
> >
> >
>
> My only concern is that we start to diverge and split into a Kubuntu Docs
> team and an Ubuntu Docs team as the help files begin to look vastly
> different.  Right now the Kubuntu Desktop Guide shares direct heritage
> from the Ubuntu Desktop Guide.  This spec calls for a total seperation of
>              the guide especially if we move away from using Docbook for
> Ubuntu and keeping w/ KDE use Docbook for Kubuntu Guides.  At that point
> it won't make any sense to have the documents written by the same team,
> different documents, different language = different teams.  At that point
> it becomes slightly harder for people to work on documentation.  "Which
> team does this doc help?"  "How do I maintain the server guide in both
> Docbook for Kubuntu and then in markup lanaguge X for Ubuntu.
> Do we really gain a vast improvment over what we currently have?
> As mentioned in the spec, licensing is a problem yet again.  Will this
> force us to change licensing again?
>
>
> --
> Jonathan Jesse
>
>
>
> --
> ubuntu-doc mailing list
> ubuntu-doc at lists.ubuntu.com
> https://lists.ubuntu.com/mailman/listinfo/ubuntu-doc
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.ubuntu.com/archives/ubuntu-doc/attachments/20061110/fd15bd61/attachment.html>