On Mon, Jan 12, 2015 at 9:27 AM, Nathann Cohen <nathann.co...@gmail.com>
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 Sage" -> FAQ, "Background jobs" -> tutorial).
>
> I began to do the work, before noticing this translation problem. I
> will continue to do this job if people here agree that this (very
> incomplete) document can be removed with all its translations, but I
> do not want to take the risk to finish all this work if I end up with
> a patch that never gets reviewed. There is something like 30 minutes
> of work ahead, or something.
>
> http://www.sagemath.org/doc/a_tour_of_sage/index.html
>
>
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 about what it should accomplish for them. The tour presumably has as
a target audience people who want to learn something about sage, probably
interactively, in about 10 minutes. And it's aimed at people who have
never used Sage before.
William
> Good evening,
>
> Nathann
>
> On 12 January 2015 at 20:37, kcrisman <kcris...@gmail.com> wrote:
> >> > 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.sagemath.org/doc/a_tour_of_sage/index.html
> >>
> >
> > Correct! Sorry if that someone became unclear in the discussion.
> >
> > --
> > 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.
>
--
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.
