mirror/emacs
1
0
Fork 0
mirror of https://git.savannah.gnu.org/git/emacs.git synced 2024-11-21 06:55:39 +00:00
Code Issues Releases Activity

Add notes about documenting default values

Browse Source 
* CONTRIBUTE: Ask people to document default values when adding new user
  options.
This commit is contained in:
Robert Pluim 2024-09-11 18:09:29 +02:00
parent 7376623a24
commit b486390862
1 changed files with 5 additions and 2 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

7
CONTRIBUTE
View File

@ -110,8 +110,11 @@ admin/notes/bug-triage.
Any change that matters to end-users should have an entry in etc/NEWS.
Try to start each NEWS entry with a sentence that summarizes the entry
and takes just one line -- this will allow reading NEWS in Outline
mode after hiding the body of each entry.
and takes just one line -- this will allow reading NEWS in Outline mode
after hiding the body of each entry. When adding a new user option that
allows changing behavior, please document its default value. Similarly,
changes to the default value of an existing user option should be
announced.
Doc-strings should be updated together with the code.