Documentation Wiki

Started by newdep, October 04, 2005, 11:28:30 PM

Previous topic - Next topic

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

#1
I second that notion.
-statik

Lutz

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



Lutz

statik

#3
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

#4
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

#5
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

#6
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