DragonFly docs List (threaded) for 2005-06
Re: handbook: cvs or wiki?
On Wed, 15 Jun 2005, Jeremy C. Reed wrote:
> The basics chapter had some modifications for the "mount" section. As the
> wiki diff output is a little unclear (for example
> I was not able to quickly see or understand all the changes.
> I looked again with a different browser and see it was just color coding
> that showed differences -- one mispelling fix.
> Then I notice that the wiki says it is the "Handbook", but in CVS is the
> "usersguide" (en/books/usersguide/book.sgml).
I was confused about that. Now I see that
DragonFly_Handbook/mount-unmount wiki page is some modification of
en/books/handbook/basics/chapter.sgml but I don't see in the wiki where it
Making a diff of this SGML and the wiki is not immediate. I guess someone
could export both to plain text and fmt the same and then diff -u. And
then add the new lines and write new docbook tags as needed.
> What is the plan for the usersguide? Should this be merged into the
> handbook? For example, maybe en/books/handbook/ports/chapter.sgml and
> en/books/usersguide/ports/chapter.sgml could be merged?
> > > I'd like to suggest that the wiki for the handbook be removed and then
> > > generate the HTML from the docbook source with a feedback form on every
> > > single handbook webpage. Then someone can share their comments and
> > > improvements easily.
> > >
> > > A committer would have to review and commit, but that is a lot easier than
> > > merging in changes later.
> > Any objections to this from other docs@ readers? I like the idea of the
> > wiki, but I'm not seeing a huge benefit from it. It may be better to
> > retry it someday when we do have a method for moving wiki -> docbook and
> > back.
Jeremy C. Reed
BSD News, BSD tutorials, BSD links