On Tue, Aug 26, 2008 at 11:07 AM, Harald Schilly <[EMAIL PROTECTED]> wrote: > > Hi, I want to propose a process to increase the quality of the Sage > documentation. This is the by far most annoying thing about Sage > according to the last survey. I think the userbase is already big and > willing enough to contribute more documentation. To do this in a more > coordinated way, there should be some sort of process and guidelines. > > I've seen a - in my eyes - very good approach at the netbeans.org > project. They organize and collect the documentation work in a > standard wiki system and maybe transform those articles or tutorials > into the official documentation later. They have a list of > contributions, a contact email address for each entry (feedback, > errors, and of course attribution! ...), a wish list, some status > information about ongoing processes, their own blog and their own > mailing list. I think, some or all of those ideas could work for Sage > as well and they are also compatible with possible paid contributors. > > Read more here > http://www.netbeans.org/community/articles/nb-communitydocs-200.html > docs: http://www.netbeans.org/community/commdocs.html > main organization page: http://wiki.netbeans.org/CommunityDocs > > I think, Sage could improve very much, by providing more documentation > towards explaining certain tasks, how they are accomplished (also > pointing out what *not* to do to avoid common pitfalls) or by > explaining basics more detailed. It is certainly not enough to point a > new user to an all-in-all documentation, because those documentations > require some knowledge about Sage in the first place, i.e. knowing > where to look for what. It is much more satisfying for new users to > present them thematically narrow examples to give them an instant > moment of success when they execute the tutorial on their own - and > then they are more encouraged to try more... > > Therefore, I hope, some folks are interested to start and once there > is already something online, more and more should come. > > ideas, thoughts, comments? H
Are you saying: "I, Harald, am willing to organize this, and I'm just curious if people think this is a good idea and would be enthuisiastic about contributing." If so, yes, I'm enthuisiastic. william --~--~---------~--~----~------------~-------~--~----~ 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 -~----------~----~----~----~------~----~------~--~---