Skip to content

Generate API and Helm reference docs - #167

Merged
EItanya merged 11 commits into
kagent-dev:mainfrom
artberger:adb-api
Aug 15, 2025
Merged

Generate API and Helm reference docs#167
EItanya merged 11 commits into
kagent-dev:mainfrom
artberger:adb-api

Conversation

@artberger

@artberger artberger commented Aug 15, 2025

Copy link
Copy Markdown
Collaborator
  • adds API docs for kagent and kmcp generated from code
  • adds Helm docs for kagent generated from code
  • adds github formatted markdown (gfm) node package to format the markdown tables that the API/Helm gen tool produces
  • adds workflow to run this automatically
  • fixes a reference to Google creds raised by Krisztian in Slack

Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
see slack: https://solo-io-corp.slack.com/archives/C0882QZ3RB6/p1755249644132989

Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
Signed-off-by: Art Berger <art.berger@solo.io>
@artberger artberger self-assigned this Aug 15, 2025
@artberger artberger added the documentation Improvements or additions to documentation label Aug 15, 2025
Comment thread package.json
"react-markdown": "^10.1.0",
"rehype-unwrap-images": "^1.0.0",
"remark-frontmatter": "^5.0.0",
"remark-gfm": "^4.0.1",

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

This is the Github formatted markdown renderer so that tables in markdown that the API/Helm generates can be rendered on the site. Before it was just passing in raw table content like:

| Field | Description | | --- | | --- | | Lorem ipsum | dolor sit amet |

@@ -0,0 +1,210 @@
name: Update Reference Documentation

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

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

similar to the workflow that we have in kgateway

@EItanya
EItanya merged commit 3c11c8c into kagent-dev:main Aug 15, 2025
3 of 4 checks passed
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants