Contributing

Thank you for your interest in improving Unison.

Branching Model

  • main – Stable, production-ready branch.
  • dev – Active development and integration branch.
  • feature/* or fix/* – Short-lived branches for specific changes.

Workflow Summary

  1. Fork the target repository and create a feature branch from dev.
  2. Make your changes and update tests and documentation.
  3. Run local tests and relevant devstack or smoke tests.
  4. Commit using clear, imperative messages.
  5. Push your branch and open a pull request against dev.

Documentation and Accessibility

  • Follow accessibility guidance similar to WCAG 2.2 AA.
  • Use semantic headings and clear, plain-language summaries.
  • Provide alt text for all images and diagrams.
  • Update architecture or journey documentation when you change behavior.

Code of Conduct and Security

  • All collaboration follows the project’s Code of Conduct.
  • Security issues should be reported responsibly using the contact information in the security policy.

For full details, see the internal CONTRIBUTING, CODE_OF_CONDUCT, and SECURITY documents in the docs repository.