Skip to content

Add MAN PAGES Documentation script#75

Merged
Vad1mo merged 8 commits into
goharbor:mainfrom
bupd:documentation
Dec 30, 2024
Merged

Add MAN PAGES Documentation script#75
Vad1mo merged 8 commits into
goharbor:mainfrom
bupd:documentation

Conversation

@bupd

@bupd bupd commented May 26, 2024

Copy link
Copy Markdown
Member

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

@ambahman ambahman left a comment

Copy link
Copy Markdown
Contributor

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

bupd commented May 27, 2024

Copy link
Copy Markdown
Member Author
  • man_doc.go will generate man pages for Command Line.
  • md_doc.go will generate markdown pages for Web UI.

@ambahman

Copy link
Copy Markdown
Contributor

we need md pages just for web UI

@bupd

bupd commented May 28, 2024

Copy link
Copy Markdown
Member Author

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
Copy Markdown
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

bupd commented May 30, 2024

Copy link
Copy Markdown
Member Author

ready for review @Vad1mo

@bupd

bupd commented Jul 25, 2024

Copy link
Copy Markdown
Member Author

@Vad1mo ready to merge!!.

This PR adds script for generating man pages doc.

@ambahman

Copy link
Copy Markdown
Contributor

The PR below is better at convincing for docs.

#115

@bupd

bupd commented Jul 25, 2024

Copy link
Copy Markdown
Member Author

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
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