uselagoon / uselagoon/lagoon-cli

Confusing docs

Open
#49 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

2023-rewrite documentation help wanted priority-medium
Dominant language
Go
Stars
28
Forks
14
Avg merge
1d 2h
Merged PRs (30d)
1

Description

Is your feature request related to a problem? Please describe.
Docs lack usage examples and lack links to related lagoon docs. There are many examples of different commands that do the same thing.

These 3 docs seem to cover the same operation but none say the difference between the 3 commands, which one should be used, no links to lagoon docs about project notifications, no examples of how to use:

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with the three linked command documentation pages and compare their descriptions, examples, and links. Clarify when each command should be used, add usage examples, and link the related Lagoon project-notification documentation; done means the overlap and differences are understandable from the docs.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
cli, documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
50/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.