Skip to content

Commit 1d0d17f

Browse files
committed
Update how we talk about Clean Architecture
1 parent 84739c8 commit 1d0d17f

File tree

1 file changed

+16
-4
lines changed

1 file changed

+16
-4
lines changed

README.md

Lines changed: 16 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,8 @@
11
# Clean Architecture
22

3-
This documents Made Tech Flavoured [Clean Architecture](https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html) which is an implementation of Robert C. Martin's Clean Architecture.
3+
How to begin with "Made Tech Flavoured Clean Architecture".
4+
5+
This style of architecture has had many names over the years including "Hexagonal", "Ports & Adapters" and "Boundary-Control-Entity".
46

57
# Getting started
68

@@ -56,12 +58,22 @@ The best way to learn Clean Architecture is through deliberate practice.
5658

5759
# Further Reading
5860

59-
Clean Architecture is a variant of [Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture) by Alistair Cockburn and,
60-
[BCE](https://www.amazon.com/Object-Oriented-Software-Engineering-Approach/dp/0201544350) by Ivar Jacobson.
61+
[Clean Architecture](https://8thlight.com/blog/uncle-bob/2012/08/13/the-clean-architecture.html) by Robert C. Martin is extremely similar in nature to
62+
63+
* [BCE](https://www.amazon.com/Object-Oriented-Software-Engineering-Approach/dp/0201544350) by Ivar Jacobson and,
64+
* [Hexagonal Architecture](http://alistair.cockburn.us/Hexagonal+architecture) (also known as **Ports & Adapters**) by Alistair Cockburn.
65+
66+
The Made Tech flavour is slightly different still to exactly what is described in [Robert C. Martin's book about Clean Architecture](https://www.amazon.co.uk/Clean-Architecture-Craftsmans-Software-Structure/dp/0134494164), the choice to rename certain basic concept is deliberate to aid:
6167

62-
The Made Tech flavour is a bit more relaxed in some areas than Hexagonal Architecture but more prescriptive than the basics of Clean Architecture and, at this time, we only have documentation about Ruby.
68+
- Learning as a Junior
69+
- Relating Interactors (Robert's name for UseCase objects) to Use Case Analysis sessions
70+
- Retaining an eye on Domain-Driven-Design i.e. What are Domain objects?
71+
- Avoiding overloading terminology e.g. Entity (Robert's name for Domain Objects) with EntityFramework Entities
72+
73+
You can think of the Made Tech flavour as being more relaxed than Hexagonal Architecture, but more prescriptive than the abstract concepts of Clean Architecture as described by Robert C. Martin's book.
6374

6475
## Reference
6576

6677
* [Clean Coders videos](https://cleancoders.com/videos/clean-code)
6778
* [Clean Architecture Book](https://www.amazon.co.uk/Clean-Architecture-Craftsmans-Software-Structure/dp/0134494164/)
79+

0 commit comments

Comments
 (0)