Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-13 Thread kcrisman
> > Note that this is not actually part of the tutorial; translations of the > > tutorial are separate documents. But your question is a good one. > > Thank you. Would you agree to have them removed? You quoted the trac > ticket for the spanish translation of this document, to bring our > a

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-13 Thread Nathann Cohen
> Note that this is not actually part of the tutorial; translations of the > tutorial are separate documents. But your question is a good one. Thank you. Would you agree to have them removed? You quoted the trac ticket for the spanish translation of this document, to bring our attention upon a s

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-13 Thread kcrisman
> > > > > > > A First Taste of Sage? > > For example. Or: "Sage for the impatient". "Sage in a nutshell". > > I like "Sage for the impatient", as long as we make it clear that it is basically a random collection of stuff. -- You received this message because you are subscribed to the Googl

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-13 Thread kcrisman
> > 2) If the document is moved to "Tutorials" with a new name, I do not > know what to do of the translations (except removing them). Or should > we have instead (many) partial translations of the tutorial which > would only contain this document ? I do not like this idea much. > > Note that

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-13 Thread Nathann Cohen
Hello again ! > Sorry -- I didn't mean to offend you -- I was just writing in a hurry when > I got a moment at the booth. Thank you for having had the patience to read what I said aftwerwards despite my first-line reaction. > OK, I am completely convinced by your arguments above. Thanks for ta

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Simon King
On 2015-01-13, Volker Braun wrote: > On Monday, January 12, 2015 at 7:16:23 PM UTC+1, Simon King wrote: >> >> If its purpose is to explain Sage for those who know other CAS, somehow >> explaining the differences and common points between various Ma* and >> Sage, then it should perhaps be kept un

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Volker Braun
On Monday, January 12, 2015 at 7:16:23 PM UTC+1, Simon King wrote: > > If its purpose is to explain Sage for those who know other CAS, somehow > explaining the differences and common points between various Ma* and > Sage, then it should perhaps be kept under a different name? A First Taste of S

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread William Stein
On Mon, Jan 12, 2015 at 11:08 AM, Nathann Cohen wrote: > > > > What is the argument for removing the tour? I have seen absolutely no > > arguments at for removing it, except maybe "the first section of that > manual > > is also named "A guided tour".' That's not a compelling argument. A > > piece

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Simon King
Hi! On 2015-01-12, kcrisman wrote: > 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 a

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread kcrisman
> > > What is the argument for removing the tour? I have seen absolutely no > > arguments at for removing it, except maybe "the first section of that > manual > > is also named "A guided tour".' That's not a compelling argument. A > > piece of our documentation has a target audience (or audience)

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Nathann Cohen
> What is the argument for removing the tour? I have seen absolutely no > arguments at for removing it, except maybe "the first section of that manual > is also named "A guided tour".' That's not a compelling argument. A > piece of our documentation has a target audience (or audience) and a goal >

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread William Stein
On Mon, Jan 12, 2015 at 9:27 AM, Nathann Cohen wrote: > Let me add here that removing "A tour of Sage" also means removing all > of its translations. And bear in mind that some (few) sections of this > document do not exist elsewhere and need to be moved to some other > document ("how to cite Sag

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Nathann Cohen
Let me add here that removing "A tour of Sage" also means removing all of its translations. And bear in mind that some (few) sections of this document do not exist elsewhere and need to be moved to some other document ("how to cite Sage" -> FAQ, "Background jobs" -> tutorial). I began to do the wo

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread kcrisman
> > > I never thought people would seriously consider deleting the main > overall > > tutorial for Sage. > > That is because nobody did. This thread is entitled "Remove 'A tour of > Sage'" and it is about whether we should remove "A tour of Sage". > > Which is this document: > http://www.sag

Re: [sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread Nathann Cohen
> -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. That is because nobody did. This thread is entitled "Remove 'A tour of Sage'" and it is about whether we should remove "A tour of Sage"

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread William Stein
On Mon, Jan 12, 2015 at 8:42 AM, kcrisman 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 >> loo

[sage-devel] Re: Remove "A Tour of Sage"

2015-01-12 Thread kcrisman
> > 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 "Tu