Update CONTRIBUTING.md information

* README.mdown: Note that bugs can be submitted to main Emacs list.
* CONTRIBUTING.md: Fix double spacing, remove carriage returns.
Tighten up commit message example.
This commit is contained in:
Noam Postavsky 2017-04-22 23:59:01 -04:00
parent 1436d211d2
commit 2a3a0cd2b1
2 changed files with 40 additions and 30 deletions

View File

@ -1,29 +1,37 @@
# Submitting Bug Reports # Submitting Bug Reports or Patches
Please read [Important note regarding bug reporting][bugnote]. As a GNU ELPA package, bugs or patches may be submitted to the main
Emacs bug list, bug-gnu-emacs@gnu.org. Alternatively, you may use the
# Contributing to Yasnippet [Github issue tracker][issues].
## Copyright Assignment Please read [Important note regarding bug reporting][bugnote].
Yasnippet is part of GNU ELPA, so it falls under the same copyright # Contributing to Yasnippet
assignment policy as the rest of Emacs (see "Copyright Assignment" in
https://www.gnu.org/software/emacs/CONTRIBUTE). A copyright assignment ## Copyright Assignment
for Emacs also covers Yasnippet.
Yasnippet is part of GNU ELPA, so it falls under the same copyright
## Commit message format assignment policy as the rest of Emacs (see "Copyright Assignment" in
https://www.gnu.org/software/emacs/CONTRIBUTE). A copyright assignment
The commit message format roughly follows Emacs conventions, although for Emacs also covers Yasnippet.
there is no separate Changelog file.
## Commit message format
The commit message's first sentence should be capitalized, no period
The commit message format roughly follows Emacs conventions. There is
It may be followed by a paragraph with a longer explanation. The no separate Changelog file.
changelog style entry goes at the end of the message.
Capitalize the first sentence, no period at the end
* foo.el (a-function): Terse summary of per-function changes.
Please make sure the summary line can be understood without having
For trivial changes, a message consisting of just the changelog entry to lookup bug numbers. It may be followed by a paragraph with a
(the `* foo.el ...` part) is fine. longer explanation. The changelog style entry goes at the end of
the message.
[bugnote]: https://github.com/joaotavora/yasnippet#important-note-regarding-bug-reporting * foo.el (a-function): Terse summary of per-function changes. Use
double spacing between sentences (set `sentence-end-double-space'
to t).
For trivial changes, a message consisting of just the changelog entry
(e.g., `* foo.el (a-function): Fix docstring typo.`) is fine.
[bugnote]: https://github.com/joaotavora/yasnippet#important-note-regarding-bug-reporting
[issues]: https://github.com/joaotavora/yasnippet/issues

View File

@ -105,7 +105,9 @@ should be added like this to `yas-snippet-dirs`:
Please refer to the comprehensive [documentation][docs] for full Please refer to the comprehensive [documentation][docs] for full
customisation and support. If you find a bug in the code or in the customisation and support. If you find a bug in the code or in the
documentation, please report it on [the GitHub issue tracker][issues]. documentation, please report it to the main Emacs bug list,
bug-gnu-emacs@gnu.org, and put "yasnippet" somewhere in the subject.
Alternatively, you may use the [Github issue tracker][issues].
## Important note regarding bug reporting ## Important note regarding bug reporting