Re: documentation for novice and newbies

On Wed, Feb 07, 2007 at 09:16:58AM -0500, Douglas Allan Tutty wrote:
I'm concerned about the newbiedoc wiki:
Its server is sometimes unavailable, so we can't get the debian
www people to add a link.

As a whole its GFDL although we could do our page GPL.

I'm concerned about the debian wiki:
The front page is immutable due to some spambot or something

One has to sign up to edit

Overall, its _looks_ unmaintained.

If we went with a wiki, we could have one long page for our project,
with sub-projects as separate chapters. We can follow the same layout
as a debiandoc e.g. release under GPL, Abstract, TOC, then the chapters.

Converting this to html is as simple as grabbing it off with a browser
and editing that to remove the "wiki" parts.

If we went with a non-wiki format then we need a home.

A home on which to develop? or a home on which to publish?
With a distributed revision control system, any site is, at least
formally, the equal of any other -- no specific home is needed.
With a wiki, the wiki site *is* home, with all the attendant
uncertainty of what to do if the wiki goes defunct.

We *do* need a site to point readers to, though, whether a wiki
or some other.

-- hendrik


What do people think?

Doug.



--
To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx
with a subject of "unsubscribe". Trouble? Contact listmaster@xxxxxxxxxxxxxxxx



--
To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx
with a subject of "unsubscribe". Trouble? Contact listmaster@xxxxxxxxxxxxxxxx

Relevant Pages

  • Re: documentation for novice and newbies
    ... That was a problem in the documentation. ... something like "For Novices and Newbies to Debian". ... Under this we could have individual wiki entries that we could work on. ... To the extent we use GPL, ...
    (Debian-User)
  • Debian Documentation and Specific HOWTOS
    ... I am writing to let you all know that I have setup a wiki which i would like to request all of the experienced mailers on this list to write some howtos for the ETCH release and of course SARGE. ... My main purpose behind this wiki was to try and get the experienced people on this list to write some howtos for the ETCH and SARGE releases of debian on some common issues, which keep getting asked on this mailing list. ... To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx with a subject of "unsubscribe". ...
    (Debian-User)
  • Re: Wiki for Java Developers Using Debian
    ... knowledge base for Java development on Debian. ... Why not integrate it into official Debian wiki? ... To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx ...
    (Debian-User)
  • Re: documentation for novice and newbies
    ... I'm concerned about the newbiedoc wiki: ... so we can't get the debian ... As a whole its GFDL although we could do our page GPL. ... To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx ...
    (Debian-User)
  • Re: documentation for novice and newbies
    ... so we can't get the debian ... Providing that we are not going to duplicate effort, you could always set up as a new project with the wiki software that has the features needed at the hoster that provides the level of service required. ... If you want a plain HTML page from NewbieDOC, just print it or download it with wget. ... To UNSUBSCRIBE, email to debian-user-REQUEST@xxxxxxxxxxxxxxxx with a subject of "unsubscribe". ...
    (Debian-User)