On Fri, Aug 22, 2008 at 3:16 AM, David Philp <[EMAIL PROTECTED]> wrote: > > > 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!
+1 I am missing this too. Also don't have time to fix it. Ondrej --~--~---------~--~----~------------~-------~--~----~ To post to this group, send email to [email protected] 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 -~----------~----~----~----~------~----~------~--~---
