-
Notifications
You must be signed in to change notification settings - Fork 180
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
docs(config): add descriptions to all configuration variables and tests #682
base: master
Are you sure you want to change the base?
docs(config): add descriptions to all configuration variables and tests #682
Conversation
Signed-off-by: David Anyatonwu <[email protected]>
Signed-off-by: David Anyatonwu <[email protected]>
✅ Deploy Preview for opal-docs canceled.
|
The PR is ready for review @gemanor |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
It is a good start, but the descriptions need to be much more descriptive. I left two examples (but there are more). Please fix them, and commit again.
POLICY_STORE_URL = confi.str( | ||
"POLICY_STORE_URL", | ||
"http://localhost:8181", | ||
description="URL of the policy store" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
This is exactly what written on the key, please explain more...
INLINE_OPA_ENABLED = confi.bool( | ||
"INLINE_OPA_ENABLED", | ||
True, | ||
description="Whether to run OPA inline within OPAL" |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Even the code comment has more description of this description. The task is to write descriptions of the variables, not just mark them as solved. Please do some understanding work around OPAL, and explain the configuration variables in a concise but descriptive way.
Signed-off-by: David Anyatonwu <[email protected]>
Done. |
@gemanor Please review. |
Hi @gemanor, I don't know if you have got time to review this. |
1 similar comment
Hi @gemanor, I don't know if you have got time to review this. |
Closes #40
/claim #40
Changes proposed
Check List (Check all the applicable boxes)