You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
While discussing some documentation improvements (see #21077 and #21121), I've noticed that several common application properties have no description in the current docs dedicated section.
However, all these properties have the descriptive comment, as visible in version 2.1.x docs which was using a different "template" for rendering documentation.
Some properties in this situation are:
spring.info.git.location
spring.data.rest.detection-strategy
spring.datasource.initialization-mode (see screenshots below)
spring.elasticsearch.rest.uris
spring.mongodb.embedded.features
After a quick look at the 2.1.x doc page, it seems that all the properties have a comment from which the description should be obtained.
This should be further investigated (maybe also checking the Default Value field too), but I have no clue on where to find the code which does this "description extraction". If someone can point me in the right direction, I'll try to have a look.
spring.datasource.initialization-mode - Current doc
spring.datasource.initialization-mode - 2.1.x doc
The text was updated successfully, but these errors were encountered:
snicoll
changed the title
Fix missing application properties descriptions in the new documentation "template"
Fix missing description for configuration keys in generated appendix
Apr 26, 2020
wilkinsona
changed the title
Fix missing description for configuration keys in generated appendix
Some entries in the tables of configuration properties are incomplete
Jun 18, 2020
While discussing some documentation improvements (see #21077 and #21121), I've noticed that several common application properties have no description in the current docs dedicated section.
However, all these properties have the descriptive comment, as visible in version
2.1.x
docs which was using a different "template" for rendering documentation.Some properties in this situation are:
spring.info.git.location
spring.data.rest.detection-strategy
spring.datasource.initialization-mode
(see screenshots below)spring.elasticsearch.rest.uris
spring.mongodb.embedded.features
After a quick look at the 2.1.x doc page, it seems that all the properties have a comment from which the description should be obtained.
This should be further investigated (maybe also checking the
Default Value
field too), but I have no clue on where to find the code which does this "description extraction". If someone can point me in the right direction, I'll try to have a look.spring.datasource.initialization-mode
- Current docspring.datasource.initialization-mode
- 2.1.x docThe text was updated successfully, but these errors were encountered: