Author ezio.melotti
Recipients bethard, docs@python, eric.araujo, ezio.melotti, georg.brandl, ncoghlan, tshepang
Date 2012-04-29.04:21:32
SpamBayes Score -1.0
Marked as misclassified Yes
Message-id <1335673293.49.0.412663048682.issue14034@psf.upfronthosting.co.za>
In-reply-to
Content
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
History
Date User Action Args
2012-04-29 04:21:33ezio.melottisetrecipients: + ezio.melotti, georg.brandl, ncoghlan, bethard, eric.araujo, docs@python, tshepang
2012-04-29 04:21:33ezio.melottisetmessageid: <1335673293.49.0.412663048682.issue14034@psf.upfronthosting.co.za>
2012-04-29 04:21:32ezio.melottilinkissue14034 messages
2012-04-29 04:21:32ezio.melotticreate