We'd love to accept your contributions (currently only accepted from contributors within the SAS organisation) and updates to this project. There are just a few small guidelines you need to follow.
Contributions to this project must be accompanied by a signed Contributor Agreement. You (or your employer) retain the copyright to your contribution, this simply gives us permission to use and redistribute your contributions as part of the project.
When adding your contribution using a Pull Request, confirm the following:
- Confirm that you have the right to submit the code that is being contributed. Please consider the origin of your code and confirm you have the appropriate rights to make the submission subject to the Apache 2.0 license that applies to everything in this repository of custom steps. If so, follow the instructions for the Contributor Agreement (which is based on the industry-standard Developer Certificate of Origin (DCO))
- Confirm that your contribution does not include any personally identifiable information (PII), for example, in any examples used in your README file.
- Confirm your contribution does not include any encryption or other export-controlled technology.
- Please adhere to the Data Guidance provided under the documentation section of this repository. It is important to use data only within the license conditions and permissibility provided by the source. Further, SAS may have additional requirements and guidelines regarding references to and usage of data.
-
Contributions are accepted as a pull request made from a fork of this project. To elaborate, when you are ready to make a contribution,
- Create a fork of this project
- Create a branch (preffered) from the fork, naming it after your intended contribution (e.g. add-loan-demo)
- Using the provided _template folder as a guide, add your demo related assets to a folder in the branch.
- Create a pull request asking for a merge of your branch to the main branch of this project
- Maintainers will get in touch with you in case of any questions and required changes.
-
Consider how an external user accesses your code for the first time, and make your demo assets as self-contained as possible.
-
As a special consideration for any data required for the demo, please refer the Data Guidance for instructions.
-
Recommendations on SAS programming best practices can be found here.
-
All submissions, including submissions by project members, require review. We use GitHub pull requests for this purpose. Consult GitHub Help for more information on using pull requests in general.