Plans for Feisty + 1
dean at deansas.org
Fri Mar 23 14:35:47 UTC 2007
-----BEGIN PGP SIGNED MESSAGE-----
Will Simpson wrote:
> On Wed, 2007-03-21 at 08:24 +0000, Phil Bull wrote:
>> Hi guys,
>> Does anyone have any plans or ideas for the documentation for Feisty+1?
> I've enjoyed work on the documentation. It has taken a while to
> understand the work flow. It really looks spiffy.
> Couple of ideas (brain dump) (mainly focused on the distributed help) --
> 1. I'd like to see an easier way to compare the currently distributed
> help with the svn tree. This probably can already be done but I'm in the
> dark. Ideally I'd like to see 2 instances of yelp running sided by side
> to compare what user community sees (Feisty) and what the state of
> development is (Feisty+1). Can this be done without setting up a vm?
You can see how a document looks in yelp by running "yelp
/path/to/file.xml" in your svn checkout, I don't know how to run it and
see it as a whole.
> 3. A list of sections needing work or adoption. I know the wiki has this
> but what about the distributed help? This could be posted weekly to the
> forum or included in the svn or posted somewhere on the wiki. I know
> that this is a moving target but for noobs like me it gives us something
> to focus on.
The status columns at https://wiki.ubuntu.com/DocumentationTeam/Projects
used to go into more detail like that. Sections marked as "help" inside
the distributed help are the ones you are looking for, assuming those
tags are kept up to date you can run "grep -r status=\"help\" *" from
within your svn checkout to get a list of sections requiring work.
> 7. A clear way that distinguishes for the user, "ubuntu" documentation
> from "upstream" documentation.
I don't understand the rationale for this, why is this a good thing?
Shouldn't it be all seamless for the user?
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v1.4.6 (GNU/Linux)
-----END PGP SIGNATURE-----
More information about the ubuntu-doc