10 шагов по решению задач в программировании

Каким боком сюда тег ооп затесался?

Обычно использую псевдокод на Haskell:

selectEvenNumbers = filter even

Помогает сразу выбросить все лишнее

Спасибо, приятно иногда еще раз удостовериться в том, что ты все в принципе делаешь правильно.

Второй вариант псевдокода из раздела 4 — это практически Python.

Поэтому если вы пишете на Python, то можно и без псевдокода обойтись :)

Начну холивар на тему комментариев.

Через месяц вы можете и не вспомнить, что означает каждая строка кода. А тот, кто будет работать с вашим кодом, вообще этого не знает. Поэтому важно писать полезные комментарии, чтобы избежать проблем и сэкономить впоследствии время, когда придётся снова вернуться к этому коду.

Я бы сказал, что комментарии уместны тогда, когда читатель понимает, что написано, но не понимает, зачем так сделано. Иными словами, комментарии отвечают не на вопрос «что?», а на вопрос «зачем?». В таком случае уместно заметить, что этот воркэраунд к такой-то проблеме или что-то вроде того. А в целом я бы выделил две основных причины, чтобы не писать комментарии:
1. Вам не нужно помнить, что делает код. Так же как не должно составлять труда понять это за считанные секунды из простых и лаконичных строк кода. Короче вся эта фигня про самодокументацию
2. Иногда комментарии «уезжают» от того кода, который они объясняют. И получается, что они только путают.

Короче, пишите нормальный код, который не требует комментариев. Оставляйте комменты только там, где непонятно, зачем вы делаете то или иное действие.