Opened 6 years ago

Closed 6 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 navigium)

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)

trac_14550_gymnasium_tutorial.patch (45.1 KB) - added by navigium 6 years ago.
New patch without pictures

Download all attachments as: .zip

Change History (18)

comment:1 Changed 6 years ago by navigium

  • 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 6 years ago by navigium

  • Description modified (diff)

comment:3 Changed 6 years ago by navigium

  • Description modified (diff)

comment:4 Changed 6 years ago by schilly

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

Changed 6 years ago by navigium

New patch without pictures

comment:5 Changed 6 years ago by navigium

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 6 years ago by leif

  • Cc leif added

comment:7 Changed 6 years ago by leif

Is this still mostly work in progress, or should we set it to "needs review"?

comment:8 Changed 6 years ago by navigium

  • Status changed from new to needs_review

comment:9 Changed 6 years ago by navigium

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 6 years ago by pdehaye

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: Changed 6 years ago by pdehaye

  • Status changed from needs_review to positive_review

comment:12 Changed 6 years ago by navigium

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: Changed 6 years ago by leif

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 6 years ago by leif

Oh, just noticed I somehow missed Paul-Olivier's previous comment ...

comment:15 in reply to: ↑ 13 Changed 6 years ago by navigium

(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 6 years ago by jdemeyer

  • Reviewers set to Paul-Olivier Dehaye

comment:17 Changed 6 years ago by jdemeyer

  • Merged in set to sage-5.10.rc0
  • Resolution set to fixed
  • Status changed from positive_review to closed
Note: See TracTickets for help on using tickets.