Skip to content
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

Merged
merged 12 commits into from
Dec 23, 2024
Merged

Config Documentation #255

merged 12 commits into from
Dec 23, 2024

Conversation

jcrichlake
Copy link
Contributor

Adding Docs

This PR adds ADRs around our usage of configs and a readme for FAQs that pertain to config questions.

Issue

SFTP config

Copy link

PR Reviewer Guide 🔍

Here are some key observations to aid the review process:

⏱️ Estimated effort to review: 2 🔵🔵⚪⚪⚪
🧪 No relevant tests
🔒 No security concerns identified
⚡ Recommended focus areas for review

Documentation Clarity
The comment added to the PartnerSettings struct could be more descriptive about the purpose and usage of the struct.

Copy link

PR Code Suggestions ✨

No code suggestions found for the PR.

@jcrichlake jcrichlake marked this pull request as ready for review December 20, 2024 15:28
Copy link
Contributor

@basiliskus basiliskus left a 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


## 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)
Copy link
Contributor

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?

Copy link
Contributor

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.

Copy link
Contributor

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

Copy link
Contributor Author

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
Copy link
Contributor

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?

Copy link
Contributor Author

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
Copy link
Contributor

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!


## Decision

We will store partner config settings in an Azure container
Copy link
Contributor

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..."

Copy link
Contributor Author

Choose a reason for hiding this comment

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

Fixed, thanks!

@jcrichlake jcrichlake merged commit 53f60b7 into main Dec 23, 2024
15 checks passed
@jcrichlake jcrichlake deleted the config-adr branch December 23, 2024 18:13
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.

6 participants