Skip to content

Comments

feat: implement transformation mechanism to improve generated cli docs#107

Open
gianarb wants to merge 1 commit intomainfrom
feat/apply-docs-markdown-transformation
Open

feat: implement transformation mechanism to improve generated cli docs#107
gianarb wants to merge 1 commit intomainfrom
feat/apply-docs-markdown-transformation

Conversation

@gianarb
Copy link
Collaborator

@gianarb gianarb commented Feb 20, 2026

The cobra generated markdown is not ideal and it needs to be tweaked a
bit in order to look right in datum.net but cobra does not offer a hook
to apply transformations during generation.

For this reason I had to implement a transformation mechanism as
second step.

There are two transformations asked by Felix:

  1. Lowercase link "SEE ALSO" to "See also"
  2. Move h1 header to h3

The cobra generated markdown is not ideal and it needs to be tweaked a
bit in order to look right in datum.net but cobra does not offer a hook
to apply transformations during generation.

For this reason I had to implement a transformation mechanism as
second step.

There are two transformations asked by Felix:

1. Lowercase link "SEE ALSO" to "See also"
2. Move `h1` header to `h3`
@gianarb gianarb force-pushed the feat/apply-docs-markdown-transformation branch from 2ed0a61 to 8763c8a Compare February 20, 2026 14:32
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant