2. General Guidelines for All Languages
2.1. Copyright
When copyright notices are added to a file, they should look like this:
Note
Copyright Notice Format
The first YYYY is the year the file was originally published. The original date is important for two reasons: when two entities claim copyright ownership of the same work, the earlier claim generally prevails; and copyright expiration is generally calculated from the original publication date. 1
If the file is modified in later years, add -YYYY with the most recent year of modification. Even though Pacemaker is an ongoing project, copyright notices are about the years of publication of specific content.
Copyright notices are intended to indicate, but do not affect, copyright ownership, which is determined by applicable laws and regulations. Authors may put more specific copyright notices in their commit messages if desired.
Footnotes
- 1
See the U.S. Copyright Office’s “Compendium of U.S. Copyright Office Practices” [https://www.copyright.gov/comp3/], particularly “Chapter 2200: Notice of Copyright”, sections 2205.1(A) and 2205.1(F), or “Updating Copyright Notices” [https://techwhirl.com/updating-copyright-notices/] for a more readable summary.
2.2. Terminology
Pacemaker is extremely complex, and it helps to use terminology consistently throughout documentation, symbol names and comments in code, and so forth. It also helps to use natural language when practical instead of technical jargon and acronyms.
For specific recommendations, see the Glossary.