Discourse Documentation Contributing/Hacking

Contributing

This document explains the processes and practices recommended for contributing enhancements to the Discourse operator.

  • Generally, before developing enhancements to this charm, you should consider opening an issue explaining your use case.
  • If you would like to chat with us about your use-cases or proposed implementation, you can reach us at Canonical Mattermost public channel or Discourse.
  • Familiarising yourself with the Charmed Operator Framework library will help you a lot when working on new features or bug fixes.
  • All enhancements require review before being merged. Code review typically examines
    • code quality
    • test coverage
    • user experience for Juju administrators of this charm. For more details, check our contibuting guide.

Developing

For any problems with this charm, please report bugs here.

The code for this charm can be downloaded as follows:

git clone https://github.com/canonical/discourse-k8s-operator

To run tests, run tox from within the charm code directory.

To build and deploy a local version of the charm, simply run:

charmcraft pack
# Ensure you're connected to a juju k8s model, assuming you're on amd64
juju deploy ./discourse-k8s_ubuntu-20.04-amd64.charm

Canonical Contributor Agreement

Canonical welcomes contributions to the Discourse Operator. Please check out our contributor agreement if you’re interested in contributing to the solution.