Skip to content

Conversation

@waldyrious
Copy link
Member

@waldyrious waldyrious commented Nov 10, 2018

This commit updates the commit message guidelines in CONTRIBUTING.md:

  • Add example commit messages for translations and for changes that affect multiple pages;
  • Prefix each example with a description of the type of change it refers to.

It also updates the PR template, to make it more compact and reduce duplication of information included in CONTRIBUTING.md:

  • Remove horizontal rule at the top
    (the comments are sufficient as visual separation);
  • Shorten the comments to make them more compact and more likely to be read;
  • Make each checklist entry take a single line;
  • Remove blank lines between checklist entries.

This is a follow-up to the discussion at #2512.

@waldyrious waldyrious added the documentation Issues/PRs modifying the documentation. label Nov 10, 2018
@waldyrious waldyrious changed the title CONTRIBUTING.md: expand commit message guidelines Update Contribution guidelines and PR template Nov 10, 2018
@waldyrious waldyrious force-pushed the contributing-commit-msgs branch from 8d35870 to 78449fe Compare November 10, 2018 16:36
@waldyrious waldyrious mentioned this pull request Nov 10, 2018
5 tasks
Copy link
Member

@sbrl sbrl left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Looks great, @waldyrious! Much briefer than our existing template.

- Add example commit messages for translations and for changes that affect multiple pages;
- Prefix each example with a description of the type of change it refers to.
- Remove horizontal rule at the top
  (the comments are sufficient as visual separation);
- Shorten the comments to make them more compact and more likely to be read;
- Make each checklist entry take a single line;
- Remove blank lines between checklist entries.
@waldyrious waldyrious force-pushed the contributing-commit-msgs branch from 78449fe to 6ec81b2 Compare November 12, 2018 13:39
@waldyrious
Copy link
Member Author

@sbrl and @pxgamer, I've updated the PR to fix the relative URL to CONTRIBUTING.md so that it works from the PR page, as discussed in the inline comments above.

@waldyrious
Copy link
Member Author

Please don't merge yet, I need to fix the issue @pxgamer pointed out in the review comments.

@waldyrious
Copy link
Member Author

waldyrious commented Nov 13, 2018

Update: I've confirmed the current URL format works as intended (see the inline conversation above for details). Feel free to merge this.

@owenvoke owenvoke merged commit c2fc820 into master Nov 13, 2018
@waldyrious
Copy link
Member Author

Oh no, @pxgamer, you squash-merged my carefully crafted separate commits 😢

Not a big deal of course :) but in the future, please keep in mind the second-to-last bullet point here when merging PRs.

@waldyrious waldyrious deleted the contributing-commit-msgs branch November 15, 2018 07:48
@owenvoke
Copy link
Member

Ah, damn it. I apologise, I completely forgot about commit history.

@waldyrious
Copy link
Member Author

No problem! 😃 this sort of thing is better gradually acquired as part of the development culture/process, rather than by memorizing rules exhaustively.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Issues/PRs modifying the documentation.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants