On Mon, Jan 12, 2015 at 8:42 AM, kcrisman <kcris...@gmail.com> wrote:
> We already have many documents that can "contain all kind of stuff" like: >> - the Constructions manual >> - the Tutorials manual >> - the Thematic Tutorials manual >> >> The difference between the last two is not precisely obvious (if you >> look for something, where will it be ?) >> >> > The "Tutorial" is the original, *general* "intro to Sage" that was written > in the age of the dinosaurs. It is still quite useful for people who > already know a similar CAS, but a lot of the content dates to when we had > much less robust communication among the various sub-parts of Sage. > "Thematic tutorials" are supposed to be, well, about some theme. > > 1) Should we remove it ? This would 'redirect' users toward more >> maintained manuals. >> > > I imagine that William or someone else added this very early on for people > familiar with Mma, and as a short document. There is a discussion at > http://trac.sagemath.org/ticket/7192 about whether we should even include > such a document. (Interestingly, it is the most-translated (because > shortest?) document we have - en, fr, de, it, pt, tr, and with zh and es > under review.) > > -1 to remove the tutorial +1 to updating and improving it I never thought people would seriously consider deleting the main overall tutorial for Sage. > > > >> 2) Alternatively, should we turn it into a section of the "Tutorial" >> manual ? Note that the first section of that manual is also named "A >> guided tour". >> http://www.sagemath.org/doc/tutorial/index.html >> >> > Yes, that is confusing. My own feeling is that it is not part of the > "Tutorial" document, but could be a "thematic" one if one wanted to keep > it. > -- William Stein Professor of Mathematics University of Washington http://wstein.org -- You received this message because you are subscribed to the Google Groups "sage-devel" group. To unsubscribe from this group and stop receiving emails from it, send an email to sage-devel+unsubscr...@googlegroups.com. To post to this group, send email to sage-devel@googlegroups.com. Visit this group at http://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.