Войти в систему

Home
    - Создать дневник
    - Написать в дневник
       - Подробный режим

LJ.Rossia.org
    - Новости сайта
    - Общие настройки
    - Sitemap
    - Оплата
    - ljr-fif

Редактировать...
    - Настройки
    - Список друзей
    - Дневник
    - Картинки
    - Пароль
    - Вид дневника

Сообщества

Настроить S2

Помощь
    - Забыли пароль?
    - FAQ
    - Тех. поддержка



Пишет superhuman ([info]superhuman)
@ 2018-01-23 20:27:00

Previous Entry  Add to memories!  Tell a Friend!  Next Entry
В каком стиле писать комментарии в коде или, скажем, отметки в системе версий? Конкретно, с большой буквы начинать, или маленькой? Закачивать точкой или нет?

Если бы они были гарантированно простыми, одним предложением, всегда бы писал с маленькой:
fixed this and that

Но иногда в одно предложение не ужаться, и выходит неразбериха. Не писать же:
fixed this and that. However, that and this is broken (в конце точка?)

Можно через запятую пробовать "fixed this and that, but that and this is broken". Потом запятой не хватает, появляется ";". Потом и этого не хватает. Писать через точку, но предложения начинать с маленькой? Криво. Писать всегда литературно, с большой буквы и точку в конце? Это уже слишком для большинства комментариев, оверкилл.

Долго меня мучает этот вопрос.


(Читать комментарии)

Добавить комментарий:

Как:
Identity URL: 
имя пользователя:    
Вы должны предварительно войти в LiveJournal.com
 
E-mail для ответов: 
Вы сможете оставлять комментарии, даже если не введете e-mail.
Но вы не сможете получать уведомления об ответах на ваши комментарии!
Внимание: на указанный адрес будет выслано подтверждение.
Имя пользователя:
Пароль:
Тема:
HTML нельзя использовать в теме сообщения
Сообщение: