Dear Thierry, If I understand you correctly, you'd like to see Sage documentation acting a bit like courseware ?
If so, I think that this is a bit peripheral to Sage *Documentation* needs, where our primary goal should be to *enhance* information availability, not hinder it. However, it might be an interesting development for cloud.sagemath.com (with another set of examples, obviously...). Sincerely, -- Emmanuel Charpentier Le vendredi 3 mars 2017 13:23:04 UTC+1, Thierry (sage-googlesucks@xxx) a écrit : > > Hi, > > currently thematic tutorials are made of examples and straightforward > application exercises. I would like to propose non-trivial exercises, so > that we should propose a solution or some hints. However, the solution > should not be readable at the first look of the page, but still accessible > by the user. > > I was thinking of: > > - having some additional EXERCISE/QUESTION/SOLUTION/ANSWER/HINT sections > similar to EXAMPLES/TESTS, for which SOLUTION/ANSWER/HINT are folded by > default. > > - having a HIDDEN_TOPIC sphinx directive similar to TOPIC which leads to a > folded block by default (TOPIC directive is used for exercises e.g. in > > http://doc.sagemath.org/html/en/thematic_tutorials/tutorial-comprehensions.html) > > > > - putting solutions in a separate file and make links to it (through it > links might be a bit fastidious to maintain). I currently do this for my > tutorials (basically i write a worksheet with solutions, and when it is > ready, i remove the solutions and produce a second worksheet). > > - you might have your own workflow for such a situations, which i am > interested in. > > It would be wonderful if this could work with sphinx (online doc) as well > as in ipynb (obtained with "sage -rst2ipynb" command) for indepentent > jupyter worksheets to be distributed to students. > > I opened https://trac.sagemath.org/ticket/22508 for that, but i am > clearly > incompetent and do not see any way to achieve that. So, any help or > suggestion would be very welcome ! > > Ciao, > Thierry > > -- 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.