8:27p |
В каком стиле писать комментарии в коде или, скажем, отметки в системе версий? Конкретно, с большой буквы начинать, или маленькой? Закачивать точкой или нет?
Если бы они были гарантированно простыми, одним предложением, всегда бы писал с маленькой: fixed this and that
Но иногда в одно предложение не ужаться, и выходит неразбериха. Не писать же: fixed this and that. However, that and this is broken (в конце точка?)
Можно через запятую пробовать "fixed this and that, but that and this is broken". Потом запятой не хватает, появляется ";". Потом и этого не хватает. Писать через точку, но предложения начинать с маленькой? Криво. Писать всегда литературно, с большой буквы и точку в конце? Это уже слишком для большинства комментариев, оверкилл.
Долго меня мучает этот вопрос. |