Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add MAN PAGES Documentation script #75

Merged
merged 8 commits into from
Dec 30, 2024
Merged

Conversation

bupd
Copy link
Contributor

@bupd bupd commented May 26, 2024

Fixes: #49

Description:

Created script to automate document generation for the cli.

  • This script will generate markdown files for all commands in harbor-cli

CLI Documentation:

  • Documented advanced features and usage scenarios.

Markdown:

  • Incorporated examples and explanations for clarity.
  • Ensured consistency with CLI documentation.

Screenshots:

Below is the example of documentation in markdown format for the harbor project command.

docGeneration

Below is the example of documentation in man format for the harbor project command.

manDoc

@bupd bupd marked this pull request as draft May 26, 2024 06:24
@bupd bupd changed the title feat: CLI Documentation script WIP: CLI Documentation script May 26, 2024
@bupd bupd force-pushed the documentation branch 2 times, most recently from 74e6e27 to e06a853 Compare May 26, 2024 13:41
@bupd bupd marked this pull request as ready for review May 26, 2024 13:47
@bupd bupd changed the title WIP: CLI Documentation script CLI Documentation script May 27, 2024
Copy link
Contributor

@amands98 amands98 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Why use two scripts, man_doc.go and md_doc.go, when we could use just one to generate Markdown files.

@bupd
Copy link
Contributor Author

bupd commented May 27, 2024

  • man_doc.go will generate man pages for Command Line.
  • md_doc.go will generate markdown pages for Web UI.

@amands98
Copy link
Contributor

we need md pages just for web UI

@bupd
Copy link
Contributor Author

bupd commented May 28, 2024

we need md pages just for web UI

Man pages are essential for every CLI tool, right? Are we missing something.

@bupd bupd force-pushed the documentation branch from e06a853 to 31ffd42 Compare May 29, 2024 18:08
@Althaf66
Copy link
Contributor

Disable those "Autogenerated by spf13/cobra" statement.

@bupd bupd force-pushed the documentation branch from 31ffd42 to 49de0ae Compare May 30, 2024 12:52
@bupd
Copy link
Contributor Author

bupd commented May 30, 2024

ready for review @Vad1mo

@bupd
Copy link
Contributor Author

bupd commented Jul 25, 2024

@Vad1mo ready to merge!!.

This PR adds script for generating man pages doc.

@amands98
Copy link
Contributor

The PR below is better at convincing for docs.

#115

@bupd
Copy link
Contributor Author

bupd commented Jul 25, 2024

The PR below is better at convincing for docs.

#115

We can use that for md docs for the website.

This PR specifically focuses on Man docs

@bupd bupd changed the title CLI Documentation script CLI MAN PAGES Documentation script Oct 20, 2024
@bupd bupd added documentation Improvements or additions to documentation question Further information is requested labels Oct 20, 2024
@bupd bupd self-assigned this Nov 26, 2024
@bupd bupd changed the title CLI MAN PAGES Documentation script Add MAN PAGES Documentation script Dec 18, 2024
bupd added 5 commits December 28, 2024 08:11
Signed-off-by: bupd <bupdprasanth@gmail.com>

add: auto documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: bupd <bupdprasanth@gmail.com>
@bupd bupd force-pushed the documentation branch 2 times, most recently from ae2d74e to dda22bf Compare December 28, 2024 04:17
Signed-off-by: bupd <bupdprasanth@gmail.com>
@bupd bupd mentioned this pull request Dec 28, 2024
@bupd bupd linked an issue Dec 28, 2024 that may be closed by this pull request
Signed-off-by: bupd <bupdprasanth@gmail.com>
@Vad1mo Vad1mo merged commit e23da81 into goharbor:main Dec 30, 2024
1 check passed
Standing-Man pushed a commit to Standing-Man/harbor-cli that referenced this pull request Feb 5, 2025
* add: auto man documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

add: auto documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

* remove md_doc generation & add man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update dagger for generating man pages

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update github workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update man doc generation

Signed-off-by: bupd <bupdprasanth@gmail.com>

* add cli and man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* move man pages to man1

Signed-off-by: bupd <bupdprasanth@gmail.com>

---------

Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: Alan Tang <jmtangcs@gmail.com>
Standing-Man pushed a commit to Standing-Man/harbor-cli that referenced this pull request Feb 5, 2025
* add: auto man documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

add: auto documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

* remove md_doc generation & add man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update dagger for generating man pages

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update github workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update man doc generation

Signed-off-by: bupd <bupdprasanth@gmail.com>

* add cli and man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* move man pages to man1

Signed-off-by: bupd <bupdprasanth@gmail.com>

---------

Signed-off-by: bupd <bupdprasanth@gmail.com>
Standing-Man pushed a commit to Standing-Man/harbor-cli that referenced this pull request Feb 5, 2025
* add: auto man documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

add: auto documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

* remove md_doc generation & add man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update dagger for generating man pages

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update github workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update man doc generation

Signed-off-by: bupd <bupdprasanth@gmail.com>

* add cli and man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* move man pages to man1

Signed-off-by: bupd <bupdprasanth@gmail.com>

---------

Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: Alan Tang <jmtangcs@gmail.com>
Standing-Man pushed a commit to Standing-Man/harbor-cli that referenced this pull request Feb 5, 2025
* add: auto man documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

add: auto documentation generate scripts

Signed-off-by: bupd <bupdprasanth@gmail.com>

* remove md_doc generation & add man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update dagger for generating man pages

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update github workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update man doc generation

Signed-off-by: bupd <bupdprasanth@gmail.com>

* add cli and man docs

Signed-off-by: bupd <bupdprasanth@gmail.com>

* update workflow

Signed-off-by: bupd <bupdprasanth@gmail.com>

* move man pages to man1

Signed-off-by: bupd <bupdprasanth@gmail.com>

---------

Signed-off-by: bupd <bupdprasanth@gmail.com>
Signed-off-by: Alan Tang <jmtangcs@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Improvements or additions to documentation question Further information is requested
Projects
None yet
Development

Successfully merging this pull request may close these issues.

registry update fails CLI Documentation
4 participants