kennethreitz/python-guide
1
0
Fork 0
mirror of https://github.com/kennethreitz/python-guide.git synced 2026-06-05 23:00:18 +00:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #684 from serra/youtube-raw

Browse Source 
Include Youtube video of reading code
This commit is contained in:
Kenneth Reitz
2016-03-14 03:32:35 -04:00
parent 7921fec0ab 5e5d548a6c
commit 4a3c975eb8
1 changed files with 8 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/writing/reading.rst
+8 -1
View File
@@ -8,6 +8,14 @@ one thing that Python programmers do is read code.
One of the secrets of becoming a great Python programmer is to read,
understand, and comprehend excellent code.
.. raw:: html
<iframe width="560"
height="315"
src="https://www.youtube.com/embed/Jc8M9-LoEuo"
frameborder="0" allowfullscreen></iframe>
Excellent code typically follows the guidelines outlined in
:ref:`code_style`, and does its best to express a clear and concise
intent to the reader.
@@ -45,7 +53,6 @@ reading. Each one of these projects is a paragon of Python coding.
- `Tablib <https://github.com/kennethreitz/tablib>`_
Tablib is a format-agnostic tabular dataset library, written in Python.
.. todo:: Embed and explain YouTube video showing python code reading: http://www.youtube.com/watch?v=Jc8M9-LoEuo This may require installing a Sphinx plugin. https://bitbucket.org/birkenfeld/sphinx-contrib/src/a09f29fc16970f34350ca36ac7f229e00b1b1674/youtube?at=default
.. todo:: Include code examples of exemplary code from each of the projects listed. Explain why it is excellent code. Use complex examples.