Разделение представления и данных приводит к тому, что мои сообщения о коммите здесь.
Ваше сообщение о фиксации не должно быть жестко заключено в любое число символов , и вместо этого следует использовать разрывы строк для разделения мыслей, абзацев и т. Д. Как части данных, а не представления. В данном случае «данные» - это сообщение, которое вы пытаетесь донести, а «представление» - это то, как пользователь видит это.
Я использую одну итоговую строку вверху и стараюсь сделать ее короткой, но я не ограничиваю себя произвольным числом. Было бы намного лучше, если бы Git фактически предоставлял способ хранить сводные сообщения как отдельную сущность от сообщения, но так как это не нужно, я должен взломать его и использовать в качестве разделителя первый разрыв строки (к счастью, многие инструменты поддерживают это означает разбить данные).
Для самого сообщения новые строки указывают на что-то значимое в данных. Одна новая строка обозначает начало / разрыв в списке, а двойная новая строка обозначает новую мысль / идею.
This is a summary line, try to keep it short and end with a line break.
This is a thought, perhaps an explanation of what I have done in human readable format. It may be complex and long consisting of several sentences that describe my work in essay format. It is not up to me to decide now (at author time) how the user is going to consume this data.
Two line breaks separate these two thoughts. The user may be reading this on a phone or a wide screen monitor. Have you ever tried to read 72 character wrapped text on a device that only displays 60 characters across? It is a truly painful experience. Also, the opening sentence of this paragraph (assuming essay style format) should be an intro into the paragraph so if a tool chooses it may want to not auto-wrap and let you just see the start of each paragraph. Again, it is up to the presentation tool not me (a random author at some point in history) to try to force my particular formatting down everyone else's throat.
Just as an example, here is a list of points:
* Point 1.
* Point 2.
* Point 3.
Вот как это выглядит в программе просмотра, которая мягко переносит текст.
Это итоговая строка, старайтесь, чтобы она была короткой и заканчивалась переводом строки.
Это мысль, возможно, объяснение того, что я сделал в удобочитаемом для человека формате. Это может быть сложным и длинным, состоящим из нескольких предложений, которые описывают мою работу в формате эссе. Сейчас не мне решать (во время автора), как пользователь будет использовать эти данные.
Два разрыва строки разделяют эти две мысли. Пользователь может читать это на телефоне или широкоэкранном мониторе. Вы когда-нибудь пытались прочитать 72-символьный текст на устройстве, которое отображает только 60 символов? Это действительно болезненный опыт. Кроме того, вступительное предложение этого абзаца (при условии формата стиля эссе) должно быть введением в абзац, поэтому, если инструмент выбирает, он может захотеть не выполнять автоматическую переноску и позволить вам просто увидеть начало каждого абзаца. Опять же, дело в том, чтобы инструмент презентации, а не я (случайный автор в какой-то момент истории), пытался заставить мое конкретное форматирование перебить всех остальных.
В качестве примера приведем список точек:
* Точка 1.
* Пункт 2.
* Пункт 3.
Мое подозрение заключается в том, что автор рекомендации по сообщению коммита Git, которую вы связали, никогда не писал программное обеспечение, которое будет использоваться широким кругом конечных пользователей на разных устройствах ранее (т. Е. На веб-сайте), поскольку на этом этапе развития Программное обеспечение / вычисления Хорошо известно, что хранение ваших данных с жестко запрограммированной презентационной информацией является плохой идеей для пользователя.