Skip to content

Commit

Permalink
Add @ConfigDocEnumValue and @ConfigDocDefault to writing-extensions g…
Browse files Browse the repository at this point in the history
…uidee
  • Loading branch information
ia3andy authored Sep 18, 2023
1 parent 5a3a825 commit e622836
Showing 1 changed file with 5 additions and 0 deletions.
5 changes: 5 additions & 0 deletions docs/src/main/asciidoc/writing-extensions.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -1316,6 +1316,11 @@ public interface SomeConfig {
}
----
<1> This will generate a configuration map key named `quarkus.some."cache-name"` instead of `quarkus.some."namespace"`.
It is possible to write a textual explanation for the documentation default value, this is usefull when it is generated: `@ConfigDocDefault("explain how this is generated")`.

Check warning on line 1320 in docs/src/main/asciidoc/writing-extensions.adoc

View workflow job for this annotation

GitHub Actions / Linting with Vale

[vale] reported by reviewdog 🐶 [Quarkus.Spelling] Use correct American English spelling. Did you really mean 'usefull'? Raw Output: {"message": "[Quarkus.Spelling] Use correct American English spelling. Did you really mean 'usefull'?", "location": {"path": "docs/src/main/asciidoc/writing-extensions.adoc", "range": {"start": {"line": 1320, "column": 92}}}, "severity": "WARNING"}

Check warning on line 1320 in docs/src/main/asciidoc/writing-extensions.adoc

View workflow job for this annotation

GitHub Actions / Linting with Vale

[vale] reported by reviewdog 🐶 [Quarkus.Spelling] Use correct American English spelling. Did you really mean 'enum'? Raw Output: {"message": "[Quarkus.Spelling] Use correct American English spelling. Did you really mean 'enum'?", "location": {"path": "docs/src/main/asciidoc/writing-extensions.adoc", "range": {"start": {"line": 1320, "column": 152}}}, "severity": "WARNING"}
`@ConfigDocEnumValue` gives a way to explicitly customize the string displayed in the documentation when listing accepted values for an enum.
====

===== Writing section documentation
Expand Down

0 comments on commit e622836

Please sign in to comment.