Em Sáb, 2008-11-15 às 15:56 -0800, mabshoff escreveu: > > > On Nov 15, 3:18 pm, Ronan Paixão <[EMAIL PROTECTED]> wrote: > > Hi, > > > I have recently opened up a page about getting started in Sage > > development in the wiki, as a suggestion from William > > > > http://wiki.sagemath.org/HowToBeginSageDevelopment > > > > following a discussion on how a newbie should start Sage development. > > > > Maybe the ticket flow information should get there. I have also added a > > link to this page from the wiki main page, in the Development section. > > > > Ronan Paixão > > In general I don't like to dump information into the wiki in an > unstructured forms, i.e. all those development resources should be in > one namespace for example. The TracGuidelines page is now more or less > in the Development Guide, so one we do the ReST transition in the next > couple weeks and we have consitent names across releases I would like > to delete the content of the wiki page and then refer to the right > page in the Development Guide and update content there. So while the > wiki is a good staging area for information I think "mature" > documentation should be moved since maintaining multiple sets of the > same info in different forms will lead to out of date information in > one form of not both. I certainly appreciate your effort here, but I > would like to maximize the benefit here, too :) > > Cheers, > > Michael
I completely agree, but the information should be somewhere easily accessible. I like the wiki interface first because I can edit it too :) but the guide is probably the best place for it to go. You say the wiki is unstructured, but I think it is only like that because we allow it. Wiki links allow for organization. Also, I like the wiki because of it's built-in search capabilities. Notice that python's docs now are generated with Sphinx, which has search capabilities. Anyway, feel free to migrate information. A central hub of information is important for any project that is complex enough (and Sage is). Ronan Paixão --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---
