Re: documentation for novice and newbies

[Chris Lale <chrislale@untrammelled.co.uk>]

Douglas Allan Tutty wrote:
> On Wed, Feb 07, 2007 at 06:16:47AM +0000, Chris Lale wrote:
>   
> > Roberto C. Sanchez wrote:
> >     
> > > On Tue, Feb 06, 2007 at 06:19:00PM -0500, Michael Pobega wrote:
> > >       
>  >  
>   
> > Osamu Aoki edits the Debian Reference etc. This is another possible 
> > model for Doug's ideas. There are many contributors but the editor 
> > produces the final document.
> >
> > A mixed system might work well. Individuals produce small articles on 
> > specific topics. An editor uses these as source material for a major 
> > article. The major article would then have a consistent flavour, but 
> > contributors still retain "ownership" of their own artcles. Contributors 
> > would be able to continue to maintain and develop their own articles. 
> > This would help in process of revising the major document.
> >     
>
> Chris,
>
> If we were to have a page clearly labled as GPL, would you be able to
> spit out an html of a wiki page any beter than we could pull off with a
> browser?
>
>   

I'm not quite sure what you mean. The wiki page is already HTML - the 
source code is the wikitext. If you use DocBook, the web page is HTML 
and the source code is the SGML/XML.

Here is a GPL wiki page (the licence notice is in an appendix):
http://newbiedoc.berlios.de/wiki/Beginner%27s_guide_to_Vi_Improved_%28Vim%29

Here is a dual-licenced wiki page (the licence notices are at the top):
http://newbiedoc.berlios.de/wiki/Aptitude_-_using_together_with_Synaptic_and_Apt-get

They are just web pages. You can view them in a browser, print them, 
download them with wget, etc. Note that if you do the latter two, a 
different CSS is involved so you see only the plain article and none of 
the website stuff. Thoughtful design by Mediawiki eh?

--
Chris.