Documentation Wiki

For the Compleat Fan
Locked
newdep
Posts: 2038
Joined: Mon Feb 23, 2004 7:40 pm
Location: Netherlands

Documentation Wiki

Post by newdep »

Hi Lutz,

Is it perhpas an Idea to extent your Newlisp Wiki (online) with a Documentation Wiki? The standard (lastest) Newlisp documention will be in it and users can add comments hints and tips and code to it?

Regards, Norman.
-- (define? (Cornflakes))

statik
Posts: 58
Joined: Thu Apr 14, 2005 1:12 am

Post by statik »

I second that notion.
-statik

Lutz
Posts: 5289
Joined: Thu Sep 26, 2002 4:45 pm
Location: Pasadena, California
Contact:

Post by Lutz »

Do you mean: there is a page for each function and you can edit/comment it?

Lutz

statik
Posts: 58
Joined: Thu Apr 14, 2005 1:12 am

Post by statik »

I am not entirely sure that either of us had put a whole lot of detailed thought into the idea, however, I know that in my experience, documentation done with wiki software has only been a good thing. You'll notice that a lot of opensource projects are moving that way, and for good reason.
-statik

Dmi
Posts: 408
Joined: Sat Jun 04, 2005 4:16 pm
Location: Russia
Contact:

Post by Dmi »

Lutz gives a good idea about "function" wiki. IMHO.
Especially with a few local functions that will be able to search, show information (man-like) and download particular function(s) to local library.
Also simple dependencies will be a good addition.

I've thinked about that last month, but I can't realize a useful technical background yet...
WBR, Dmi

newdep
Posts: 2038
Joined: Mon Feb 23, 2004 7:40 pm
Location: Netherlands

Post by newdep »

Perhpas mixing the tics&tricks with an online Function/Document wiki?

Somewhere where users can put there "smart" remarks or additional
findings on functions...

Its just an idea but it must have added value ofcourse ;-)

Regards, Norman
-- (define? (Cornflakes))

Dmi
Posts: 408
Joined: Sat Jun 04, 2005 4:16 pm
Location: Russia
Contact:

Post by Dmi »

One problem is here: It is about the _code_ that could be modifyed by everyone and once upon a time be blindy downloaded by someone...
I think, personal/collective authorized repositories with one general index (like debian's package ones) will be safer...
WBR, Dmi

Locked