Skip to content

docs(gazelle): Use definition lists instead of bullets for Gazelle docs#3154

Merged
dougthor42 merged 3 commits intobazel-contrib:mainfrom
dougthor42:u/dthor/gazelle-docs-def-list
Aug 8, 2025
Merged

docs(gazelle): Use definition lists instead of bullets for Gazelle docs#3154
dougthor42 merged 3 commits intobazel-contrib:mainfrom
dougthor42:u/dthor/gazelle-docs-def-list

Conversation

@dougthor42
Copy link
Copy Markdown
Collaborator

Primary updates:

  • Use Definition List
  • Move the annotation/directive description to the definition line

Secondary updates:

  • Add missing directive arguments. For example, # gazelle:python_extension becomes # gazelle:python_extension value.
  • Address WIP lines for "allowed values"
  • Link things with {term}.

Fixes #3142.

Primary updates:
+ Use Definition List
+ Move the annotation/directive description to the definition line

Secondary updates:
+ Add missing directive arguments. For example, `#
  gazelle:python_extension` becomes `# gazelle:python_extension value`.
+ Address WIP lines for "allowed values"
+ Link things with `{term}`.

Fixes bazel-contrib#3142.
@dougthor42 dougthor42 added type: documentation gazelle Gazelle plugin related issues labels Aug 8, 2025
@dougthor42 dougthor42 marked this pull request as ready for review August 8, 2025 01:07
@dougthor42 dougthor42 requested a review from aignas as a code owner August 8, 2025 01:07
@aignas
Copy link
Copy Markdown
Collaborator

aignas commented Aug 8, 2025

Consider adding a note in the CHANGELOG about the gazelle docs - this is something that may be good to not forget when making the next release announcement.

+ Add note about Gazelle docs move
+ Fix missing backticks
+ Fix EOL whitespace
@dougthor42 dougthor42 requested a review from rickeylev as a code owner August 8, 2025 19:21
@dougthor42 dougthor42 added this pull request to the merge queue Aug 8, 2025
Merged via the queue into bazel-contrib:main with commit bc788d5 Aug 8, 2025
3 checks passed
@dougthor42 dougthor42 deleted the u/dthor/gazelle-docs-def-list branch August 8, 2025 21:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

gazelle Gazelle plugin related issues type: documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

chore: See if Gazelle docs would look better with a definition list

2 participants