Hi Nathann, On Fri, Mar 5, 2010 at 4:18 AM, Nathann Cohen <nathann.co...@gmail.com> wrote:
<SNIP> > Actually, I wouldn't know where to write them. Some of it already > appears along the code as comments, but I wouldn't know where to write > all this. Were you thinking about copying it inside the function's > documentation ? I was thinking of a central document called, say, "Graph Theory Problems and Their LP Formulation". This document would include the materials in the document you posted above, but also flesh it out with more explanation and examples of Sage usage. As for where to incorporate the new document into the Sage standard documentation, I think your document fits nicely with the Sage Constructions Document [1]. That document already has a chapter on graph theory, and one on linear programming. Perhaps you can, if time permits, polish your (PDF) document, making it into a chapter for the Sage Constructions Document. You could call this new chapter "Graph Theory Problems and Their LP Formulation" and put it below the chapter "Linear Programming". > In this pdf (which is, firstly, easier to write than a Sphinx file), I > did not care about defining properly what is a graph, or explaining > elementary notions... This is more meant to be read as a help to > reviewers, or by people who already know most of what it does. I > barely defined problems, said two things were equivalent without > proving it, etc... This makes your document fits nicely into the Sage Construction Document. As far as my understanding goes, one is not required to define basic notions such as "graph", "edges", "vertices", "linear programming", "spanning trees", etc. Instead, a main purpose of the Sage Construction Document is to collect together in a central place various domain-specific tutorials demonstrating how to use Sage for the domain under consideration. For instance, the Sage Construction Document includes the following domain-specific tutorials: * Calculus * Plotting * Group theory * Representation theory * Python functional programming > Perhaps it could fit better into the book you're working on, which > deals with Sage and Graph Theory, though... ;-) You know me too well :-) Indeed, David Joyner and I have been making some progress on that algorithmic graph theory book [2]. I very much love to include your materials in that book. If you have time, please open a new "issue" on the book's project website. The book is licensed under the GNU Free Documentation License. Unless your PDF document (or its corresponding LaTeX file) is released under the GNU FDL, I would need to "reverse engineer" your documentation. In short, I love to have your PDF document in the graph theory book, but I respectfully request that you license it under the GNU FDL so that the said document could be included verbatim in the book. [1] http://www.sagemath.org/doc/constructions/ [2] http://code.google.com/p/graph-theory-algorithms-book/ -- Regards Minh Van Nguyen -- To post to this group, send an email to sage-devel@googlegroups.com To unsubscribe from this group, send an email to sage-devel+unsubscr...@googlegroups.com For more options, visit this group at http://groups.google.com/group/sage-devel URL: http://www.sagemath.org
