Skip to content

Fixes #19255: Improved documentation consistency for configuration default values #19258

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Conversation

mr1716
Copy link
Contributor

@mr1716 mr1716 commented Apr 22, 2025

Fixes: #19255

The changes ensure that the default values are highlighted the same way in the documentation

@mr1716 mr1716 changed the title #19255 improve documentation consistency for configuration default values Fixes #19255 improve documentation consistency for configuration default values Apr 23, 2025
@mr1716 mr1716 changed the title Fixes #19255 improve documentation consistency for configuration default values Fixes #19255: Improved documentation consistency for configuration default values Apr 23, 2025
@jeremystretch jeremystretch self-requested a review April 24, 2025 13:01
@@ -2,7 +2,7 @@

## PLUGINS

Default: Empty
Default: `Empty`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Empty" isn't a literal value. We should either leave this as is, or change it to "[] (empty)"

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jeremystretch thanks. Will switch it to []

@@ -13,7 +13,7 @@ A list of installed [NetBox plugins](../plugins/index.md) to enable. Plugins wil

## PLUGINS_CONFIG

Default: Empty
Default: `Empty`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar to PLUGINS above, but this is an empty dictionary by default.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jeremystretch thanks. Will switch it to []

@@ -206,14 +206,14 @@ If `STORAGE_BACKEND` is not defined, this setting will be ignored.

## TIME_ZONE

Default: UTC
Default: `UTC`
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It might help to represent this explicitly as a string to avoid confusion with a global constant.

Suggested change
Default: `UTC`
Default: `"UTC"`

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@jeremystretch thanks. Change made

@mr1716
Copy link
Contributor Author

mr1716 commented Apr 24, 2025

@jeremystretch requested changes made. Thanks for the review and happy to change as otherwise needed

Copy link
Member

@jeremystretch jeremystretch left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @mr1716!

@jeremystretch jeremystretch merged commit 02f51bc into netbox-community:main Apr 24, 2025
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.

Improve Documentation Consistency For Configuration Default Values
2 participants