Installation usability testing

[Max Kanat-Alexander]

Gervase Markham wrote:
> Have we considered using wiki-style change control?

	We considered using the Wiki for all our docs. I think there was a 
thread on it on this list, maybe several years ago. If it's not here, 
there's a chance it was a meeting that we talked about it in, and it 
will be in the minutes or logs somewhere.

	I agree that it should be easier to edit the docs. I do want to keep 
the following features of DocBook, however:

	1) Localization. We just changed the directory structure of the docs to 
allow localization, so it'd be nice to keep allowing that whatever we 
decide.

	2) Different docs for different branches.

	3) (This isn't required, but it's nice.) Different formats, like text, 
PDF, etc.

	There are lots of tools and processes that the Fedora Docs project has 
developed that might be able to help us out, but first we have to move 
to having our docs compile with xmlto instead of jade.

	We might be able to consider adopting a commit-then-review policy for 
certain committers, on the docs. We'd want to be sure of their language 
skills, their knowledge of Bugzilla, and their technical documentation 
abilities, first.

	-Max
-- 
http://www.everythingsolved.com/
Competent, Friendly Bugzilla and Perl Services. Everything Else, too.