Update 18_comments.md

devmanInstructor · devmanInstructor · commit f197ad0d33a0 · 2021-02-10T16:52:04.000+04:00
Лена добавила раздел Что изучать в статью про комментарии
diff --git a/1_python_basics/18_comments.md b/1_python_basics/18_comments.md
@@ -2,7 +2,7 @@
 
 ### Обычные комментарии
 
-Комментарии – способ прокомментировать код на ходу, на той же строке. 
+Комментарии – способ прокомментировать код на ходу, на той же строке.
 
     price = Column(BigInteger)  # рубли * 100
 
@@ -56,7 +56,7 @@
 
 ### Не сопровождать комментарии
 
-Другая частая ошибка: не менять комментарии при изменении кода. В примере выше мы загружали данные из файла. 
+Другая частая ошибка: не менять комментарии при изменении кода. В примере выше мы загружали данные из файла.
 Через месяц взялись за голову и поселили данные в базе данных. Код стал таким:
 
     # загружаем данные из файла data.json
@@ -94,3 +94,11 @@
   или `FIXME: учитывать часовой пояс`.
 
 Прежде чем написать комментарий, попробуй поселить его в коде, указав параметр или дав подходящее название переменной.
+
+
+## Что изучать
+
+- [Доклад Григория Петрова про комментирование исходников](https://www.youtube.com/watch?v=-SRUctRR_4s). Обязателен к просмотру.
+- [PEP 257](https://www.python.org/dev/peps/pep-0257/). ПЕП про докстринги.
+- [doctest](https://docs.python.org/3.5/library/doctest.html). Документация к модулю про доктесты.
+- [What is the best comment in source code you have ever encountered?](http://stackoverflow.com/questions/184618/). Шутить в коде не стоит, а вот посмеяться с чужих шуток можно. Это ж не нам поддерживать.
