DragonFly BSD
DragonFly docs List (threaded) for 2004-12
[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]

Re: Wiki-fying docs


From: Hiten Pandya <hmp@xxxxxxxxxxxxx>
Date: Wed, 01 Dec 2004 20:16:08 +0000

Stu wrote:
On Mon, 29 Nov 2004 18:02:50 +0000, Hiten Pandya <hmp@xxxxxxxxxxxxx>
wrote:


Justin C. Sherrill wrote:

I've noticed that there's been a number of people who have wanted to
contribute to docs, but the process of installing the doc-proj port and
all its dependencies, plus talking SGML, plus building it, is forming a
sort of barrier to entry.  I think I'm the only poor soul that's done it.

I was thinking we could copy the existing docs into a Wiki, and see how
contributions change from there. Mashing wiki changes back into CVS may
be less laborious than putting other people through the docproj wringer. Can anyone think of any objections?

Let's not use Wiki for professional project documentation.


Sure, use it as a staging area, but not for the final thing.

-Hiten


Id help if it used wiki, but not if I had to docbook.
(for the life of me, I couldnt get jade/sgml/docbook etc
installed/working under fbsd4. there was always something..)


I understand people want to contribute, but just because one is not ready to go through the hurdle of groking SGML/XML shall we abandon the system. That's not how it should be answered.

	To summarise and end this thread, I would conclude that using
	something like a DragonFly MediaWiki would be a good place for
	staging the documentation, and then "by-hand" people can
	merge changes into the SGML version of the documentation.

	We would also need to make it clear on the MediaWiki site that
	any contributions made to do the Wiki-version of the docs will
	be covered by the DragonFly's BSD license.

-Hiten



[Date Prev][Date Next]  [Thread Prev][Thread Next]  [Date Index][Thread Index]