On 22/08/2008, at 11:00 AM, Mike Hansen wrote:
>> The documentation system I want to see is a centralised wiki. It >> works like this: >> help(var) gets you the [locally cached] copy of the documentation. > > I think these are two orthogonal problems. Do you mean something like > this http://sd-2116.dedibox.fr/pydocweb/wiki/Front%20Page/ ? They are orthogonal but you might think about them at the same time. By the look of it, that is like what I meant. Basically, every time I find myself looking at a manpage, I am thinking "I've read this before, but how..." I then think "I wish this was wikipedia so I could put the example in until someone comes up with a better one." That's the problem I want fixed. I think it arises because developers of software packages tend to write documentation for themselves, so every documentation page tends to read like an interface specification rather than providing pedagogical examples and "you might be looking for XYZ" links. Sage is already better than some others. I certainly don't have time to do it. If someone likes the idea please run with it! D --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to sage-devel@googlegroups.com To unsubscribe from this group, send email to [EMAIL PROTECTED] For more options, visit this group at http://groups.google.com/group/sage-devel URLs: http://www.sagemath.org -~----------~----~----~----~------~----~------~--~---
