Комментарии 5
Каким боком сюда тег ооп затесался?
Обычно использую псевдокод на Haskell:
Помогает сразу выбросить все лишнее
selectEvenNumbers = filter evenПомогает сразу выбросить все лишнее
Спасибо, приятно иногда еще раз удостовериться в том, что ты все в принципе делаешь правильно.
Второй вариант псевдокода из раздела 4 — это практически Python.
Поэтому если вы пишете на Python, то можно и без псевдокода обойтись :)
Начну холивар на тему комментариев.
Я бы сказал, что комментарии уместны тогда, когда читатель понимает, что написано, но не понимает, зачем так сделано. Иными словами, комментарии отвечают не на вопрос «что?», а на вопрос «зачем?». В таком случае уместно заметить, что этот воркэраунд к такой-то проблеме или что-то вроде того. А в целом я бы выделил две основных причины, чтобы не писать комментарии:
1. Вам не нужно помнить, что делает код. Так же как не должно составлять труда понять это за считанные секунды из простых и лаконичных строк кода. Короче вся эта фигня про самодокументацию
2. Иногда комментарии «уезжают» от того кода, который они объясняют. И получается, что они только путают.
Короче, пишите нормальный код, который не требует комментариев. Оставляйте комменты только там, где непонятно, зачем вы делаете то или иное действие.
Через месяц вы можете и не вспомнить, что означает каждая строка кода. А тот, кто будет работать с вашим кодом, вообще этого не знает. Поэтому важно писать полезные комментарии, чтобы избежать проблем и сэкономить впоследствии время, когда придётся снова вернуться к этому коду.
Я бы сказал, что комментарии уместны тогда, когда читатель понимает, что написано, но не понимает, зачем так сделано. Иными словами, комментарии отвечают не на вопрос «что?», а на вопрос «зачем?». В таком случае уместно заметить, что этот воркэраунд к такой-то проблеме или что-то вроде того. А в целом я бы выделил две основных причины, чтобы не писать комментарии:
1. Вам не нужно помнить, что делает код. Так же как не должно составлять труда понять это за считанные секунды из простых и лаконичных строк кода. Короче вся эта фигня про самодокументацию
2. Иногда комментарии «уезжают» от того кода, который они объясняют. И получается, что они только путают.
Короче, пишите нормальный код, который не требует комментариев. Оставляйте комменты только там, где непонятно, зачем вы делаете то или иное действие.
Зарегистрируйтесь на Хабре, чтобы оставить комментарий
10 шагов по решению задач в программировании