You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 2 Next »

Overview

In general, some good practices we recommend include:

  • Documentation: Add a clear body of text with purpose, usage instructions, dependencies, easy to copy-paste examples, and troubleshooting steps for common issues.
  • Versioning: Follow the semantic versioning 2.0.0 convention (see specification details).
  • Inputs & Outputs: If deployable, adopt technology-specific standards for exposing the Item's inputs and outputs (e.g. variables.tf on Terraform, vars.yml in Ansible, etc).
  • Testing: If executable, make sure the results of execution are consistent or reproducible between runs.
  • Contribution Guidelines: If you are planning to accept contributions from other community members, is best to specify per writing which steps they should follow such that your collaborate is friction-free.


Example Repositories

You are encouraged to take inspiration or borrow from EWC-supported Items and adopt similar implementation patterns, helping to increase the overall consistency of the Community Hub. Feel free to review the structure, README or CONTRIBUTING style, CI/CD automation, and dependencies of Items according to their technology classification, starting with examples such as:

Whenever possible reuse dependencies, especially those listed in EWC-supported Items. These are well-maintained and versatile building blocks designed to perform only one task, but perform it in the best possible way. EWC-supported building blocks are publicly available as GitHub repositories, at https://github.com/orgs/ewcloud/repositories.

  • No labels