b8a2bb3b27
Implements `make docs` command to create rtd-themed docs using Sphinx from the existing Markdown documents in the docs directory. Changes the `get-modules` command to `depend` to more closely match OpenStack guidelines in [0]. Adds `fmt` command as specified in [0], currently referencing the `lint` command. Adds `godoc` command that will host a local godoc server instance with a link directly to airshipctl technical documentation. Adds `releasenotes` commands specified in [0], currently noted as "TODO". Adds `images` command as found in other Airship projects, referencing `docker-image`. [0] https://governance.openstack.org/tc/reference/pti/golang.html Change-Id: I134fc2c2714bce6d23dc9cf8b86c3016d68def7e
2.0 KiB
Contributing Guidelines
The airshipctl project accepts contributions via gerrit reviews. For help getting started with gerrit, see the official OpenDev documentation. This document outlines the process to help get your contribution accepted.
Support Channels
Whether you are a user or contributor, official support channels are available here
You can also report bugs.
Before opening a new issue or submitting a patchset, it's helpful to search the bug reports above - it's likely that another user has already reported the issue you're facing, or it's a known issue that we're already aware of. It is also worth asking on the IRC channels.
Story Lifecycle
The airshipctl project uses Jira to track all efforts, whether those are contributions to this repository or other community projects. The Jira issues are a combination of epics, issues, subtasks, bugs, and milestones. We use epics to define large deliverables and many epics have been created already. The project assumes that developers trying to break down epics into managable work will create their own issues/stories and any related subtasks to further breakdown their work. Milestones act as human readable goals for the sprint they are assigned to.
The airshipctl project leverages 1-month sprints primarily for the purpose of chronologically ordering work in Jira.
Coding Conventions
Airship has a set of coding conventions that are meant to cover all Airship subprojects.
However, airshipctl also has its own specific coding conventions and standards in the official airshipctl developer guide.