Commit graph

21 commits

Author SHA1 Message Date
Kynan Ware
944543863a
Revert "[gh config] Escape pipe symbol in Long desc for website manual" 2025-05-20 08:54:30 -06:00
Azeem Sajid
a4b86bff77 Use HTML numeric code instead of escaping with slash 2025-02-04 18:48:56 +05:00
Azeem Sajid
800a645e0e [gh config] Escape pipe symbol in Long desc for website manual 2025-02-04 18:16:13 +05:00
Yukai Chou
687a43fe89 Drop surplus trailing space char in flag names in web
Introduced by 92cb2cc7 (more closely match cobra default val display,
2023-12-05).
2024-08-23 02:15:07 +08:00
gabemontero
39e4cbd973 update generated content for man pages and website 2024-05-17 09:30:53 -04:00
Babak K. Shandiz
ad71f8cf9f
Output JSON Fields section in Markdown
Signed-off-by: Babak K. Shandiz <babak.k.shandiz@gmail.com>
2024-05-06 18:00:54 +01:00
Zack Sloane
b6dadfa7fb test update, more consistent default value display 2024-01-08 23:23:24 -05:00
Zack Sloane
857cd49040 fix special cases for duration flags 2023-12-05 23:33:01 -05:00
Zack Sloane
92cb2cc78d more closely match cobra default val display 2023-12-05 22:21:53 -05:00
Zack Sloane
aae4a00769 Add default values to docs (web and man pages) 2023-11-30 16:28:51 -05:00
Mislav Marohnić
278ff59fce
Allow accessing Cobra built-in doc generation features
Setting GH_COBRA allows access to Cobra's built-in implementation of generating man pages and markdown trees. This is useful for testing and comparing our overrides against Cobra's own logic.
2022-11-09 17:30:32 +01:00
Mislav Marohnić
b12ea845ef
Migrate to the new Cobra command grouping feature 2022-11-09 16:42:13 +01:00
Mislav Marohnić
6e9974c2ef Escape liquid tags in site docs
It is good practice to wrap all dynamic content in `{% raw %}..{% endraw %}`
Liquid tags so that no syntax within can mistakenly get interpreted as
Liquid tags. Fixes rendering of `gh auth login` help page.
2022-09-19 15:50:51 +02:00
Abirdcfly
b998f3912d
remove duplicate "the" words in comments 2022-08-21 11:11:39 +08:00
Mislav Marohnić
a7254ac43f Improve markdown rendering of man pages for commands
- "Examples" section now renders with syntax highlighting and doesn't
  interpret curly braces as Liquid tags anymore
- Flags are now listed with nicer formatting than just being rendered to
  a plain text block
- Flags are now listed above the "Examples" section
- The `--help` flag is no longer explicitly and repetitively being
  listed as an inherited flag under every command
- Usage synopsis line is now rendered early in the documentation for a
  command
- Every command that has subcommands now explicitly lists those
  subcommands in its documentation
2021-11-03 16:59:14 +01:00
Sam Coe
86906c6769
Small cleanup 2020-11-04 12:40:40 +03:00
Sam Coe
241e90aa9b
Make markdown:generate annotation a markdown generation override for hidden commands 2020-11-04 12:35:58 +03:00
Sam Coe
f770c6481c
Generate markdown for help topics 2020-11-04 12:35:58 +03:00
Sam
f8ce68f062
Remove SEE ALSO from markdown docs generation 2020-10-22 12:59:11 +02:00
Sam
699c9ae131
Remove Cobra autogenerated string from docs generation 2020-10-22 12:59:11 +02:00
Sam
36949e263a Internalize doc generation from Cobra 2020-10-22 09:38:51 +00:00