[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2021-03-25 Thread Raymond Hettinger
Raymond Hettinger added the comment: I would think this would go without saying. The word "tutorial" means example driven instruction. Previous to now, no one has ever reported confusion about this. -- nosy: +rhettinger ___ Python tracker

[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2021-03-25 Thread Irit Katriel
Change by Irit Katriel : -- assignee: -> docs@python components: +Documentation nosy: +docs@python versions: -Python 3.5, Python 3.6, Python 3.7 ___ Python tracker ___ __

[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2020-05-24 Thread Chas Belov
New submission from Chas Belov : 7.2.7. Code Examples https://devguide.python.org/documenting/#code-examples states: Short code examples can be a useful adjunct to understanding. Readers can often grasp a simple example more quickly than they can digest a formal description in prose. [snip]

[issue40758] For 7.2.7. Code Examples, distinguish between the Tutorial and other documentation

2020-05-24 Thread Chas Belov
Change by Chas Belov : -- versions: +Python 3.5, Python 3.6, Python 3.7, Python 3.8, Python 3.9 ___ Python tracker ___ ___ Python-bu