Opened 8 years ago
Closed 8 years ago
#14550 closed enhancement (fixed)
German tutorial for school teachers (mainly aimed at Gymnasium level)
Reported by: | navigium | Owned by: | mvngu |
---|---|---|---|
Priority: | major | Milestone: | sage-5.10 |
Component: | documentation | Keywords: | |
Cc: | pdehaye, schilly, leif | Merged in: | sage-5.10.rc0 |
Authors: | Beni Keller | Reviewers: | Paul-Olivier Dehaye |
Report Upstream: | N/A | Work issues: | |
Branch: | Commit: | ||
Dependencies: | Stopgaps: |
Description (last modified by )
As discussed in this sage-devel thread
https://groups.google.com/forum/?fromgroups=#!topic/sage-devel/ZvN_rtDavnk
I wrote a tutorial for German school teachers on gymnasium level on how they could use Sage to do the calculations they need for math on this level.
The attached patch creates a section called "thematische anleitungen" in the German documentations, similar to the "thematic tutorials" in the English documentation.
Attachments (1)
Change History (18)
comment:1 Changed 8 years ago by
- Description modified (diff)
- Summary changed from German tutorial for school teachers (mainly at Gymnasium level) to German tutorial for school teachers (mainly aimed at Gymnasium level)
comment:2 Changed 8 years ago by
- Description modified (diff)
comment:3 Changed 8 years ago by
- Description modified (diff)
comment:4 Changed 8 years ago by
comment:5 Changed 8 years ago by
Ok, removed the pictures again. I just included them today because there were some part that were hard to understand without visualisation. But of course this works without the pictures, also it's not the best solution as long as the document isn't accessible in a interactive mode.
I thought since there are thematic tutorials in the English documentation containing pictures, this should be fine.
comment:6 Changed 8 years ago by
- Cc leif added
comment:7 Changed 8 years ago by
Is this still mostly work in progress, or should we set it to "needs review"?
comment:8 Changed 8 years ago by
- Status changed from new to needs_review
comment:9 Changed 8 years ago by
Sorry, I forgot to set it to "needs review". This isn't work in progress, it's a finished document. (Which doesn't mean that it can't be extended, but it includes everything I planned to include in the beginning.) I also gave it to two people to read and review before posting the patch - again, this doesn't mean that there isn't still a odd spelling mistake here and there.
comment:10 Changed 8 years ago by
On its own, the patch is good. It passes all the tests when I doctest the files in that folder. I would mark it as positive review, except for the patchbot's complaints. Apparently the doc didn't build in the later patchbot tests, which trips other unrelated tests (because of search_src).
Probably explained by ongoing experiments with the patchbot, see https://groups.google.com/forum/?fromgroups#!topic/sage-devel/vGBz9MeUV4U
comment:11 follow-up: ↓ 13 Changed 8 years ago by
- Status changed from needs_review to positive_review
comment:12 Changed 8 years ago by
I see that one of the tests that fails is a complaint about non-ascii characters. Since this is a German document, it needs non-ascii characters. Is there a way to tell the patch bot that this is a utf-8 document other than starting the documents with
.. -*- coding: utf-8 -*-
?
comment:13 in reply to: ↑ 11 ; follow-up: ↓ 15 Changed 8 years ago by
Replying to pdehaye:
Accepted (see https://groups.google.com/d/topic/sage-devel/vGBz9MeUV4U/discussion )
? That thread refers to patchbot testing.
Do we meanwhile have a spell- and grammar checker plug-in as well? ;-)
(Müsste jetzt in meinen Notizen graben; OTOH: Definitiv wenige Typos, aber z.B. "Zahlen -> Ziffern", inkonsistentes "[Gg]raf*" vs. "[Gg]raph*", und paar inhaltliche Sachen...)
comment:14 Changed 8 years ago by
Oh, just noticed I somehow missed Paul-Olivier's previous comment ...
comment:15 in reply to: ↑ 13 Changed 8 years ago by
(Müsste jetzt in meinen Notizen graben; OTOH: Definitiv wenige Typos, aber z.B. "Zahlen -> Ziffern", inkonsistentes "[Gg]raf*" vs. "[Gg]raph*", und paar inhaltliche Sachen...)
Lass mich wissen, was korrigiert werden muss (abgesehen von dem schon genannten).
comment:16 Changed 8 years ago by
- Reviewers set to Paul-Olivier Dehaye
comment:17 Changed 8 years ago by
- Merged in set to sage-5.10.rc0
- Resolution set to fixed
- Status changed from positive_review to closed
I've started to look at it briefly. The first issue is, that as far as I know no images are allowed. They bloat the already largish Sage codebase by something which can be replicated at any time. I don't know the best solution w/ regards of – for example – the interactive help, but it's certainly example possible to include the plotting command as an example without showing the plot.
see: http://sagemath.org/doc/tutorial/tour_plotting.html