Skip to content

Commit

Permalink
fix wording for better clarity
Browse files Browse the repository at this point in the history
  • Loading branch information
zakirullin committed Nov 23, 2024
1 parent fb765a8 commit 956804f
Showing 1 changed file with 1 addition and 1 deletion.
2 changes: 1 addition & 1 deletion README.md
Original file line number Diff line number Diff line change
Expand Up @@ -263,7 +263,7 @@ If you think that such layering will allow you to quickly replace a database or
> will be depended on by somebody.
> [The law of implicit interfaces](https://www.hyrumslaw.com/)
We did a storage migration, and that took us about 10 months. The old system was single-threaded, so the exposed events were sequential. All our systems depended on that observed behaviour. A new distributed storage didn't have that guarantee - the exposed events came out-of-order. This behavior was not part of the API contract, it was not reflected in the code. We spent only a few hours writing a new storage adapter for the existing data abstraction layer. We spent the rest of the months on dealing with out-of-order events and other challenges. It's now funny to say that layering helps us replace components quickly.
We did a storage migration, and that took us about 10 months. The old system was single-threaded, so the exposed events were sequential. All our systems depended on that observed behaviour. This behavior was not part of the API contract, it was not reflected in the code. A new distributed storage didn't have that guarantee - the events came out-of-order. We spent only a few hours coding a new storage adapter for the existing data abstraction layer. We spent the next 10 months on dealing with out-of-order events and other challenges. It's now funny to say that layering helps us replace components quickly.

**So, why pay the price of high cognitive load for such a layered architecture, if it doesn't pay off in the future?** Plus, in most cases, that future of replacing some core component never happens.

Expand Down

0 comments on commit 956804f

Please sign in to comment.