CONTRIBUTING.md

ansible_aws_deployer

If you're reading this, hopefully you are considering helping out with the Ansible AWS Deployer for RH enablement.

Herein lies the contribution guidelines for helping out with this project. Do take the guidelines here literally, if you find issue with any of them or you see room for improvement, please let us know via a GitHub issue.

Rules

• The Ansible Code of Conduct still applies.
• Should you wish to work on a completely new standard, GREAT, but please file an issue for tracking.
• To contribute, fork and make a pull request against the "opentlc-shared-reorg" branch.
• All tasks should be in YAML literal.

# This
- name: Create a directory
  file:
      state: directory
      path: /tmp/deletethis

# Not this
- name: Create a directory
  file: state=directory path=/tmpt/deletethis

• There should be no space before a task hyphen

# This
- name: Do something

# Not this
   - name: Do something

• Module arguments should be indented two spaces

# This
- name: Create a directory
  file:  
    state: directory
    path: /tmp/deletethis

# Not This
- name: Create a directory
  file:
      state: directory
      path: /tmp/deletethis

• There should be a single line break between tasks
• Tags should be in multi-line format and indented two spaces just like module arguments above

# This
- name: "Check hosts.equiv"
  stat:
    path: /etc/hosts.equiv
  register: hosts_equiv_audit
  always_run: yes
  tags:
    - tag1
    - tag2


# Not This
- name: "Check hosts.equiv"
  stat:
      path: /etc/hosts.equiv
  register: hosts_equiv_audit
  always_run: yes
  tags: [tag1,tag2]
     - tag1
     - tag2

• Every task must be named and provide brief descriptions about the task being accomplished.