ADRs: 017-019 - Adding Impact Sections #1628
Conversation
tjohnson7021
added
the
devex/opex
PR Reviewer Guide 🔍Here are some key observations to aid the review process:
|
![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?s=60&v=4){kind=small}
|
|
||
| ### Positive | ||
|
|
||
| - **High Performance:** HikariCP outperforms other connection pool libraries in terms of throughput and latency, enhancing application responsiveness. |
There was a problem hiding this comment.
Consider adding specific examples or metrics to support claims about performance and scalability in the Impact section. This would provide clearer insights into the benefits of using HikariCP for connection pooling. [important]
|
|
||
| ### Risks | ||
|
|
||
| - **Migration Errors:** Incorrectly defined migration scripts could cause deployment failures or data integrity issues. |
There was a problem hiding this comment.
It might be beneficial to include a subsection under Risks about potential security concerns with migration scripts, such as exposure of sensitive data or SQL injection risks, and how to mitigate them. [important]
|
|
||
| ### Negative | ||
|
|
||
| - **Increased Complexity:** Adds another table to the database, which introduces additional queries and joins in the codebase. |
There was a problem hiding this comment.
To enhance the Negative section, consider discussing the potential increase in maintenance costs associated with managing an additional table, especially in terms of database administration and backup complexities. [medium]
PR Code Suggestions ✨No code suggestions found for the PR. |
tjohnson7021
requested review from
basiliskus,
sfradkin,
luis-pabon-tf,
JeremyIR,
halprin,
saquino0827,
somesylvie,
jorg3lopez,
jbiskie,
brick-green,
pluckyswan,
GilmoreA6,
jherrflexion and
jcrichlake
| - **Operational Challenges:** Monitoring and maintaining the pool in production environments may require additional effort. | ||
|
|
||
|
|
||
| - **Dependency Lock-in:** Switching to another connection pooling library in the future may require significant refactoring. |
There was a problem hiding this comment.
Should our use of OEA reduce this to limited refactoring?
There was a problem hiding this comment.
We aren't including mitigations for these ADRs, but if we did, I would definitely be including this answer. I think the fact that we recognize (and document) that we are aware of this risk resolves this story.
This reverts commit 7728b0f.
- Changelog Structure and Dependencies
- added suggested risk language in regards to adding another table increases potential rollback complexity
|
tjohnson7021
deleted the
devex/1247-add_impact_sections_to_adrs_017-019
branch
Description
This PR covers filling in the impact sections for ADRs 017-019 so that it is understood why the decision was made at the time and what the concerns were.
This PR errs on the side of being more verbose than not so that unneeded items can be stripped away during review, so please read carefully.
Issue #1247
Checklist