Hi! On 2017-02-06, Clemens Heuberger <clemens.heuber...@aau.at> wrote: > Am 2017-02-05 um 03:22 schrieb kcrisman: >> >> "Tutorial", "Thematic Tutorial", "PREP Tutorial", "A Tour of Sage". and >> "Constructions" are mostly the same Tutorial. >> >> >> Just for clarification, these are massively and completely different >> documents. >> There is also a lot of overlap, but the audiences are very different. The >> challenge is getting the right people to the right tutorial/introduction, or >> perhaps writing new ones and making them easy to find. ... > one more point: as part of the sage source tree, these tutorials are tested > regularly and so it is guaranteed that they work with the most recent sage > version.
Exactly. I wouldn't like to have documentation that is *not* included in the SageMath sources. Currently, one can access all documentation locally, during a SageMath session. Usually I find it very very easy to search for relevant documentation in SageMath - say, by search_def or search_src or by ? or ?? or tab completion. Actually I believe that the documentation is a strength of SageMath. However, the paragraph above indicates a problem: Before being able to enjoy the good SageMath documentation, one needs to learn how to access stuff. For newbies, it might be problematic to some extent. But this problem cannot be solved by removing the above tools. Instead, newbies should be pointed to using them. So, perhaps/probably it is possible to improve sagemath.org. E.g., I find the front page ok, but I find both the download page and the page "help/documentation" confusing: Both consist of very long lists of links (e.g., to download servers or to separate chapters of the PDF documentation or different languages). On the "help/documentation" page, I'd prefer a list of the available documents and for each item on the list a drop-down menue for choosing one's language. And please not a bunch of links named "Ref: Probability Ref: Quadratic Forms etc" on that page. Instead, there could be a link "Chapters" that leads to a table of contents. Best regards, Simon -- 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 https://groups.google.com/group/sage-devel. For more options, visit https://groups.google.com/d/optout.
