Skip to content

Latest commit

 

History

History
125 lines (93 loc) · 6.22 KB

CONTRIBUTING.md

File metadata and controls

125 lines (93 loc) · 6.22 KB

Please be sure to read the NAPALM contributing guidelines.

Contribution Guidelines

If you're reading this, you're probably thinking about contributing to this repository. We really appreciate that--thank you!

This document provides guidelines on contributing to this repository. Please follow these guidelines when creating issues, making commits, and submitting pull requests. The repository maintainers review all pull requests and verify that they conform to these guidelines before approving and merging.

Table Of Contents

How Can I Contribute?

Licensing

Coding Conventions

Additional Notes

How Can I Contribute?

Contribution Ideas

  1. Raise issues for bugs, features, and enhancements.
  2. Submit updates and improvements to the documentation.
  3. Submit articles and guides, which are also part of the documentation.
  4. Help out repo maintainers by answering questions in Airheads Developer Community.
  5. Share feedback and let us know about interesting use cases in Airheads Developer Community.

What should I know before I get started?

The best way to directly collaborate with the project contributors is through GitHub.

  • If you want to raise an issue such as a defect, an enhancement request, feature request, or a general issue, please open a GitHub issue.
  • If you want to contribute to our code by either fixing a problem, enhancing some code, or creating a new feature, please open a GitHub pull request against the development branch.

Note: All pull requests require an associated issue number, must be made against the development branch, and require acknowledgement of the DCO. See the Licensing section below.

Before you start to code, we recommend discussing your plans through a GitHub issue, especially for more ambitious contributions. This gives other contributors a chance to point you in the right direction, give you feedback on your design, and help you find out if someone else is working on the same thing.

It is your responsibility to test and verify, prior to submitting a pull request, that your updated code doesn't introduce any bugs. Please write a clear commit message for each commit. Brief messages are fine for small changes, but bigger changes warrant a little more detail (at least a few sentences). Note that all patches from all contributors get reviewed. After a pull request is made, other contributors will offer feedback. If the patch passes review, a maintainer will accept it with a comment. When a pull request fails review, the author is expected to update the pull request to address the issue until it passes review and the pull request merges successfully.

At least one review from a maintainer is required for all patches.

Licensing

All contributions must include acceptance of the DCO:

Developer’s Certificate of Origin

Developer Certificate of Origin Version 1.1

Copyright (C) 2004, 2006 The Linux Foundation and its contributors. 660 York Street, Suite 102, San Francisco, CA 94110 USA

Everyone is permitted to copy and distribute verbatim copies of this license document, but changing it is not allowed.

Developer's Certificate of Origin 1.1

By making a contribution to this project, I certify that:

(a) The contribution was created in whole or in part by me and I have the right to submit it under the open source license indicated in the file; or

(b) The contribution is based upon previous work that, to the best of my knowledge, is covered under an appropriate open source license and I have the right under that license to submit that work with modifications, whether created in whole or in part by me, under the same open source license (unless I am permitted to submit under a different license), as indicated in the file; or

(c) The contribution was provided directly to me by some other person who certified (a), (b) or (c) and I have not modified it.

(d) I understand and agree that this project and the contribution are public and that a record of the contribution (including all personal information I submit with it, including my sign-off) is maintained indefinitely and may be redistributed consistent with this project or the open source license(s) involved.

Sign Your Work

To accept the DCO, simply add this line to each commit message with your name and email address (git commit -s will do this for you):

Signed-off-by: Jane Example <[email protected]>

For legal reasons, no anonymous or pseudonymous contributions are accepted.

Coding Conventions

  1. Python code should conform to PEP-8. PyCharm editor has a built-in PEP-8 checker.
  2. Since this is a collaborative project, document your code with comments that will help other contributors understand the code you write.
  3. When in doubt, follow conventions you see used in the source already.

Additional Notes

Note: Please don't file an issue to ask a question. Please reach out to us via email or discussion forums.

Resources

Resource Description
Aruba Developer Hub Aruba Developer Hub that showcases all automated solutions for Aruba products.
Airheads Developer Community Aruba Airheads forum to discuss all things network automation.
Aruba Bots Automate Videos YouTube playlist containing instructional videos for Ansible and Python automation repositories.
[email protected] Distribution list email to contact the Aruba Automation Technical Marketing Engineering team.