Logo Questions Linux Laravel Mysql Ubuntu Git Menu
 

What is the difference between summary and description in GitHub Desktop?

Though I don't find it annoying or anything like that but I just wanted to know how is specifying either of the summary or description different while making a commit using the desktop version on GitHub? How do I provide these two together on terminal using git commit ?

like image 963
Naman Avatar asked Apr 02 '16 05:04

Naman


People also ask

What is summary and description in GitHub desktop?

The summary is the first line of a commit message: it summarizes the reason for the commit (why, not what) See "The Art of the Commit" The rest goes into the description.

What is commit description?

A commit in GitHub is described as a saved change. A commit message explains what change you made to your project. It is greatly important to learn how to make a good commit message no matter if it is a personal or professional project.


1 Answers

The summary is the first line of a commit message: it summarizes the reason for the commit (why, not what)
See "The Art of the Commit"

The rest goes into the description.

enter image description here


By convention, that first line is not supposed to be more than 50 characters:
See this template

# <type>: (If applied, this commit will...) <subject> (Max 50 char)
# |<----  Using a Maximum Of 50 Characters  ---->|


# Explain why this change is being made
# |<----   Try To Limit Each Line to a Maximum Of 72 Characters   ---->|

# Provide links or keys to any relevant tickets, articles or other resources
# Example: Github issue #23

Other Git GUIs do enfornce the same summary/description convention, like Atomio:

https://cdn-images-1.medium.com/max/1200/1*dSJ0TgQUPX2ukRwgZi9RBQ.gif

like image 64
VonC Avatar answered Oct 19 '22 20:10

VonC