-
Notifications
You must be signed in to change notification settings - Fork 3
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
Config Documentation #255
Config Documentation #255
Conversation
Co-Authored-By: jcrichlake <[email protected]>
PR Reviewer Guide 🔍Here are some key observations to aid the review process:
|
PR Code Suggestions ✨No code suggestions found for the PR. |
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.
Looks good, just left one question
adr/012-configs.md
Outdated
|
||
## Notes | ||
- config files should only contain non-secret values | ||
- secrets will use a consistent naming pattern based on the partner ID used in config (so we can dynamically assemble the key names in code) |
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.
Is the naming convention documented somewhere?
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.
SECRETS.md contains the current naming convention for secrets.
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 might be helpful to link out to it
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 has been added to where the notes were moved which is in configs.md
Co-Authored-By: jcrichlake <[email protected]>
# FAQ | ||
- We use the partner's organization name in ReportStream as the partner ID | ||
- Config files are the partner ID plus `.json` | ||
- Config keys in code are the partner ID |
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.
Could an example of what that would look like be added?
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.
Added
@@ -0,0 +1,11 @@ | |||
# FAQ |
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.
Loving the FAQ section. Great idea!
adr/012-configs.md
Outdated
|
||
## Decision | ||
|
||
We will store partner config settings in an Azure container |
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.
nit: consider being more specific here, .i.e. "We will store partner sftp config settings..."
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.
Fixed, thanks!
Quality Gate passedIssues Measures |
Adding Docs
This PR adds ADRs around our usage of configs and a readme for FAQs that pertain to config questions.
Issue
SFTP config