Skip to content

Commit

Permalink
docs: tweak wording
Browse files Browse the repository at this point in the history
  • Loading branch information
jolexxa committed Jul 8, 2024
1 parent b586608 commit 02f7eeb
Showing 1 changed file with 3 additions and 2 deletions.
5 changes: 3 additions & 2 deletions src/content/docs/development/philosophy.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -17,7 +17,7 @@ We believe a good software architecture is defined by the following qualities:
- 💪 Consistent: offer strong opinions to complex problems, like state management.
- 🧘‍♀️ Flexible: enable features to be easily refactored or replaced.
- 🤓 Approachable: facilitate rapid onboarding and training, even for junior developers.
- 🧪 Testable: make it easy to achieve 100% unit test coverage.
- 🧪 Testable: easy to create automated tests and achieve 100% code coverage.
- 🏎️ Performant: execute quickly by default.
- 📱 Multiplatform: build one app that works on every platform.

Expand All @@ -33,7 +33,7 @@ To build complex, enterprise-grade software, we need to find a way to make doing

## 🍰 Layered Architecture

For client applications, we follow a variation of layered architecture consisting of 3 main layers: presentation, business logic, and data.
For client applications, we follow a variation of [layered architecture][very-good-layered-architecture] consisting of 3 main layers: presentation, business logic, and data.

By clearly differentiating between architectural boundaries, we drastically reduce the amount of knowledge required to contribute to a single layer, as well as improve the code's readability and reduce the cognitive load required to maintain it. Separating layers allows us to test each piece of code individually (i.e., unit testing).

Expand Down Expand Up @@ -166,3 +166,4 @@ As a team, we have many cumulative years of experience with apps of all kinds, f
[declarative]: https://stackoverflow.com/a/15382180
[time-complexity]: https://en.wikipedia.org/wiki/Time_complexity
[pub.dev]: https://pub.dev
[very-good-layered-architecture]: https://verygood.ventures/blog/very-good-flutter-architecture

0 comments on commit 02f7eeb

Please sign in to comment.