[Docs] Add note on module development about the copyrights (#26812)
* Add note on module development about the copyrights This matches what's in CODING_GUIDELINES.md as of July 2017 * Add recommendation for standardizing on `Copyright (c) 2017 Ansible Project` * s/with/should have/ * Fix more unicode
This commit is contained in:
parent
cf34cefbdc
commit
beca565c79
1 changed files with 45 additions and 6 deletions
|
@ -14,11 +14,12 @@ syntax highlighting before you include it in your Python file.
|
||||||
|
|
||||||
All modules must have the following sections defined in this order:
|
All modules must have the following sections defined in this order:
|
||||||
|
|
||||||
1. ANSIBLE_METADATA
|
1. Copyright
|
||||||
2. DOCUMENTATION
|
2. ANSIBLE_METADATA
|
||||||
3. EXAMPLES
|
3. DOCUMENTATION
|
||||||
4. RETURNS
|
4. EXAMPLES
|
||||||
5. Python imports
|
5. RETURNS
|
||||||
|
6. Python imports
|
||||||
|
|
||||||
.. note:: Why don't the imports go first?
|
.. note:: Why don't the imports go first?
|
||||||
|
|
||||||
|
@ -30,6 +31,41 @@ All modules must have the following sections defined in this order:
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
Copyright
|
||||||
|
----------------------
|
||||||
|
|
||||||
|
The beginning of every module should look about the same. After the shebang,
|
||||||
|
there should be at least two lines covering copyright and licensing of the
|
||||||
|
code.
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
#!/usr/bin/python
|
||||||
|
# Copyright (c) 2017 Ansible Project
|
||||||
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||||
|
|
||||||
|
Every file should have a copyright line with the original copyright holder.
|
||||||
|
Major additions to the module (for instance, rewrites) may add additional
|
||||||
|
copyright lines. Code from the Ansible community should typically be assigned
|
||||||
|
as "Copyright (c) 2017 Ansible Project" which covers all contributors. Any
|
||||||
|
legal questions need to review the source control history, so an exhaustive
|
||||||
|
copyright header is not necessary.
|
||||||
|
|
||||||
|
The license declaration should be ONLY one line, not the full GPL prefix. If
|
||||||
|
you notice a module with the full prefix, feel free to switch it to the
|
||||||
|
one-line declaration instead.
|
||||||
|
|
||||||
|
When adding a copyright line after completing a significant feature or rewrite,
|
||||||
|
add the newer line above the older one, like so:
|
||||||
|
|
||||||
|
.. code-block:: python
|
||||||
|
|
||||||
|
#!/usr/bin/python
|
||||||
|
# Copyright (c) 2017 [New Contributor(s)]
|
||||||
|
# Copyright (c) 2015 [Original Contributor(s)]
|
||||||
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||||
|
|
||||||
|
|
||||||
ANSIBLE_METADATA Block
|
ANSIBLE_METADATA Block
|
||||||
----------------------
|
----------------------
|
||||||
|
|
||||||
|
@ -116,7 +152,8 @@ Include it in your module file like this:
|
||||||
.. code-block:: python
|
.. code-block:: python
|
||||||
|
|
||||||
#!/usr/bin/python
|
#!/usr/bin/python
|
||||||
# Copyright header....
|
# Copyright (c) 2017 [REPLACE THIS]
|
||||||
|
# GNU General Public License v3.0+ (see COPYING or https://www.gnu.org/licenses/gpl-3.0.txt)
|
||||||
|
|
||||||
DOCUMENTATION = '''
|
DOCUMENTATION = '''
|
||||||
---
|
---
|
||||||
|
@ -126,6 +163,8 @@ Include it in your module file like this:
|
||||||
'''
|
'''
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
The following fields can be used and are all required unless specified otherwise:
|
The following fields can be used and are all required unless specified otherwise:
|
||||||
|
|
||||||
:module:
|
:module:
|
||||||
|
|
Loading…
Reference in a new issue