Font Awesome Free 5.13.0 by @fontawesome - https://fontawesome.com License - https://fontawesome.com/license/free (Icons: CC BY 4.0, Fonts: SIL OFL 1.1, Code: MIT License)

Boundaries and duplication

Why duplication is not always bad and how architectural boundaries can create false duplication

False duplication

Watch out for false duplication!

  • Real duplication: duplicates always have to change together
    • This is the kind of duplication you really want to avoid
  • False duplication: code/structures/... that are identical now but likely to change at different times or for different reasons
    • Common with vertical slicing, where certain functionalities may start out looking similar but end up diverging significantly
    • Can also happen with horizontal slicing, for example the apparent duplication between a database row and the corresponding structure we send to the UI
      • It may be tempting to pass the database row directly to the UI, and in some cases this can be a good idea, but it isn’t hard to imagine that the structure of the data to show in the UI and the structure of the data in the DB could have to change independently of each other
    • The fact that two things are the same at this moment does not necessarily mean that they are real duplicates and that that apparent duplication is a bad thing
    • Attempts to get rid of false duplication tend to lead to unnecessary coupling through shared code, which will then come back to bite you when the “duplicates” suddenly need to change independently of each other

Advice:

  • Don't blindly follow the Don't Repeat Yourself (DRY ) whenever you see duplication
  • What typically happens when trying to get rid of false duplication:
    1. Someone sees the duplication and creates an abstraction (function, class, ...) holding the duplicated code. The abstraction is now shared between all places that had the duplicated code before.
    2. Requirements change and one of the places that had the duplicated code now needs to do something slightly different.
    3. The developer implementing the change sees the abstraction and feels obligated to keep it. They extend it with a parameter to trigger the slightly different behavior.
    4. Repeat 3 and 4 until the abstraction's code becomes a mess containing way too much behavior as well as being very risky and hard to modify when needed.
  • Better principle to follow: Avoid Hasty Abstractions (AHA Programming )
    • "Prefer duplication over the wrong abstraction"

Data duplication and bounded contexts

See Microservices

Resources