Information

Founded
1994
Website
www.nixsolutions.com
Employees
1,001–5,000 employees
Registered

Habr blog

Pull to refresh
Comments 5
Обычно использую псевдокод на Haskell:
selectEvenNumbers = filter even

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

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


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

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


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

Короче, пишите нормальный код, который не требует комментариев. Оставляйте комменты только там, где непонятно, зачем вы делаете то или иное действие.
Only those users with full accounts are able to leave comments. Log in, please.