Hacker Newsnew | past | comments | ask | show | jobs | submitlogin

I was recently advised to use the "commit messages are subjects" style, but I get a pang of... something, every time I have to omit the full stop (I always type it out of habit and then press backspace).

I agree completely with Antirez, messages are not subjects or titles, and we should make them as succinct as possible, not force ourselves to write something that leads into a full-text piece only to omit the latter.

If it can fit in one line, make it fit, otherwise summarize the change as well as you can. Our goal should be to have to read the least amount of text to understand what the change is doing, and the hierarchy is: short commit message > long commit message > diff.



    I get a pang of... something, every time I have to omit the full stop 
Good. :) One thing that's very nice about the full stop:

You know that you've read to the end of something.

In the absence of one, there's always the chance that text has been cut off


Cut off what? The suspense is killing me!




Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact

Search: