why o why

[Karsten Wade]

On Thu, 2005-04-21 at 11:17 -0500, Eric Rostetter wrote:
> Quoting Rahul Sundaram <sundaram at redhat.com>:
> 
> > I suspect that learning how a wiki system manages all this would have a
> > similar learning curve to using CVS and Docbook.
> 
> Yes, but it isn't really apples to apples.
> 
> The wiki setup would promote more community participation in the docs.
> The current system promotes single author docs.
> 
> So, the question becomes do we want to foster an environment of cooperative
> documentation writing, or of individual documentation writing?

Both. :)

I don't think either system is exclusive of either method.  Personally,
I'd rather work collaboratively on a multiple-XML file document than
with page locking in a Wiki enforced by a browser.

Our processes need to address taking a doc from idea to publication a
level higher than the specific tool used.

> > We really should be
> > more worried about getting suitable content rather than refining the
> > submission process now. 
> 
> But the wiki may do just that, by allowing more people to participate.
> It does this, in part, by allowing people to each spend less time on
> the job, by working with others.

Which is a valid point, but it brings us away from focusing on more
content and back into focusing on tools and existing processes.  We can
certainly revise them iteratively, and in fact are working on that.

- Karsten
-- 
Karsten Wade, RHCE * Sr. Tech Writer * http://people.redhat.com/kwade/
gpg fingerprint:  2680 DBFD D968 3141 0115    5F1B D992 0E06 AD0E 0C41   
                       Red Hat SELinux Guide
http://www.redhat.com/docs/manuals/enterprise/RHEL-4-Manual/selinux-guide/
-------------- next part --------------
A non-text attachment was scrubbed...
Name: signature.asc
Type: application/pgp-signature
Size: 189 bytes
Desc: This is a digitally signed message part
URL: <http://listman.redhat.com/archives/fedora-docs-list/attachments/20050421/679fc238/attachment.sig>