Message159570
A few more comments:
* in the review I mentioned highlighting specific code lines (this would be really great given the incremental nature of the howto), but apparently that requires a pygment 1.1 [0].
* all the output examples could use ".. highlightlang:: sh", but:
1. the sh highlighter is not so good imho;
2. you would have to switch back and forth from sh and python (unless there's a better way to do it);
* the sidebar box with the tutorial looks better if you put it between the <hr> and the introductory paragraph.
Maybe Georg has something to say about the first two comments.
[0]: see last example in http://sphinx.pocoo.org/markup/code.html#line-numbers |
|
Date |
User |
Action |
Args |
2012-04-29 04:21:33 | ezio.melotti | set | recipients:
+ ezio.melotti, georg.brandl, ncoghlan, bethard, eric.araujo, docs@python, tshepang |
2012-04-29 04:21:33 | ezio.melotti | set | messageid: <1335673293.49.0.412663048682.issue14034@psf.upfronthosting.co.za> |
2012-04-29 04:21:32 | ezio.melotti | link | issue14034 messages |
2012-04-29 04:21:32 | ezio.melotti | create | |
|