19 Commits

Author SHA1 Message Date
Sreejith Punnapuzha
7526c22444 Update developer guide for deployment with proxy
This commit updates the developers.md file with the files where proxy
have to be set. Also give an example of user-data for proxy setting
in ephemeral node.

Depends-On: https://review.opendev.org/#/c/723057/

Change-Id: I9812cee8cd76807353c05aca1dc4ff9adba62f9b
Signed-off-by: Sreejith Punnapuzha <sreejith.punnapuzha@outlook.com>
2020-04-28 11:08:18 -05:00
Ian Howell
9ffc305392 Define a standard for creating commands
This commit cleans up the command constructors in an attempt to make the
codebase more uniform and approachable. This includes several refactors:

* Removed the FlagConstants - this makes the help messages and examples
  significantly more readable without needed to compile and run
  airshipctl
* Long help messages and examples are now constant
* Short, Long, and Examples all begin with a capitol letter
* Flag descriptions begin with a lowercase letter. This matches the flag
  description for the builtin "help" flag, making formatting uniform for
  all flags
* Removed redundant unit tests on non-leaf commands

This change also updates the documentation for the affected commands.

Change-Id: I8b9dcbfd9846b3deaab06dec17f80643dae78de9
2020-04-24 10:50:59 -05:00
Drew Walters
edf3523138 Add simple proxy guidelines
There are currently no guidelines provided for using airshipctl behind a
corporate proxy server even though additional configuration is
necessary.

This change adds a simple proxy guide that outlines the requirements for
running airshipctl behind a simple proxy server.

Change-Id: I7b4959e1758ff4dfccdf3aec0e569aa77214bd3e
Signed-off-by: Drew Walters <andrew.walters@att.com>
2020-04-20 20:44:45 +00:00
Noor Muhammad Malik
e650468379 Create documentation for new developers
This patch updates the develop documentation in docs/source/developers.md.
Adds details on environment setup and uses some of the scripts available
in tools/gate directory.

Change-Id: I76d426746f668f89ab4f9e43ac00f75f47735702
Relates-To: #72
Closes: #72
2020-04-08 19:22:27 +05:00
Alexander Hughes
26fdd05b0f [#38] Add end-user documentation to project
1. Add end-user documentation of CLI commands
2. Minor refactor of several help messages
3. Update of golden test data to reflect help message changes

Change-Id: I58b8ac3a7871efdb569887ab65191bfb1842c24e
Signed-off-by: Alexander Hughes <Alexander.Hughes@pm.me>
2020-03-10 16:45:19 +00:00
Alexander Hughes
feb8e4e484 [#85] update testing documentation
This change updates testing documentation to take advantage of the
new make target included in [0]

[0]: https://review.opendev.org/#/c/711050/

Relates-To: #85

Change-Id: I25d7ee22f9cc5fcef38354a8eafb17c780240977
Signed-off-by: Alexander Hughes <Alexander.Hughes@pm.me>
2020-03-09 12:00:04 +00:00
Drew Walters
d902cb98e3 [#59] Add Airship logo to docs
This change adds the Airship logo to our documentation.

Change-Id: Ie3d068eea2e3545fa38f35f6f7a1e1869360ffac
Signed-off-by: Drew Walters <andrew.walters@att.com>
2020-02-20 11:33:24 -06:00
Ian H Pittwood
6cb70e7eb3 [#17] Fixes to airshipctl docs
Various typo fixes in documents

Various grammar and language changes for clarification

Change-Id: I111bf45c90405a26d09a5254733a055c78b47407
2020-02-10 19:25:07 +00:00
Ian H. Pittwood
b8a2bb3b27 Updates to Makefile
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
2020-01-10 09:20:10 -06:00
Alexander Hughes
960e816c23 Minor document fixes
- Links to CONTRIBUTORS.md and testing-guidelines.md were broken.
- Minor fix to escaping of the (c) bulletpoint in contribution
  guidelines.

Change-Id: Iffb5233b50008a4e4e4fd17be483d7e8c1ee4856
2020-01-03 16:36:56 +00:00
Alexander Hughes
358a7e9882 Minor documentation cleanup
This patch makes minor documentation fixes:
1. Wording of make images
2. Document rendering of bullet point c instead of a copyright symbol
3. Fix broken link for contributing docs
4. Use https for quay link instead of http
5. Limit line lengths to 80 characters

Change-Id: I8c6d339251e454b357d6eaeb125b925c209e8577
2019-12-16 09:48:04 -06:00
Ian Howell
3e08db66bd Fix testing-guidelines.md link
Change-Id: I644235c09935b4d55edad2587e448dd96715ad13
2019-12-06 15:23:37 -06:00
Alan Meadows
87f48407a7 Update README with a more accurate project description
Change-Id: I805a569c3624e30862dbba4b613aa9b683af54a3
2019-11-18 15:56:40 -08:00
Zuul
d462b8a014 Merge "Initial Contributions and Developer Docs" 2019-11-07 20:56:39 +00:00
Alan Meadows
7328c22a3e Initial Contributions and Developer Docs
This commit forms a starting point for our CONTRIBUTING.md
and developer documentation.

Change-Id: I7de8ad19e658a849208c18a3339c1f01a95471d5
2019-11-07 10:48:32 -08:00
Ian Howell
d4dab71f86 Add testing expectations
* Documents the expectations for unit-tests
* Updates the tests to the version command so as to provide a clear
  example of how to test commands.

Change-Id: I3fbb509a2e4298b4ae68200764a6034459b61602
2019-11-07 11:37:53 -06:00
Ian Howell
6e41a56a7d Rename module to reflect its new location
Change-Id: I5c8c524c4d3f569b21b5b829722b3c49952cb0ab
2019-07-01 12:15:29 -05:00
Ian Howell
3c02f845d0 Remove argo 2019-06-13 08:12:45 -05:00
Ian Howell
eb79dff0c9 Add detailed documentation on plugins 2019-06-07 11:35:51 -05:00