@@ -19,7 +19,7 @@ Easy structuring of a project means it is also easy
1919to do it poorly. Some signs of a poorly structured project
2020include:
2121
22- - Multiple and messy circular dependencies: If your classes
22+ - Multiple and messy circular dependencies: if your classes
2323 Table and Chair in furn.py need to import Carpenter from workers.py
2424 to answer a question such as table.isdoneby(),
2525 and if conversely the class Carpenter needs to import Table and Chair,
@@ -28,13 +28,13 @@ include:
2828 fragile hacks such has using import statements inside
2929 methods or functions.
3030
31- - Hidden coupling: Each and every change in Table's implementation
31+ - Hidden coupling: each and every change in Table's implementation
3232 breaks 20 tests in unrelated test cases because it breaks Carpenter's code,
3333 which requires very careful surgery to adapt the change. This means
3434 you have too many assumptions about Table in Carpenter's code or the
3535 reverse.
3636
37- - Heavy usage of global state or context: Instead of explicitly
37+ - Heavy usage of global state or context: instead of explicitly
3838 passing ``(height, width, type, wood) `` to each other, Table
3939 and Carpenter rely on global variables that can be modified
4040 and are modified on the fly by different agents. You need to
@@ -43,14 +43,14 @@ include:
4343 template code is also modifying this context, messing with
4444 table dimensions.
4545
46- - Spaghetti code: Multiple pages of nested if clauses and for loops
46+ - Spaghetti code: multiple pages of nested if clauses and for loops
4747 with a lot of copy-pasted procedural code and no
48- proper segmentation are known as spaghetti code. Python's
48+ proper segmentation are known as spaghetti code. Python's
4949 meaningful indentation (one of its most controversial features) make
5050 it very hard to maintain this kind of code. So the good news is that
5151 you might not see too much of it.
5252
53- - Ravioli code is more likely in Python: It consists of hundreds of
53+ - Ravioli code is more likely in Python: it consists of hundreds of
5454 similar little pieces of logic, often classes or objects, without
5555 proper structure. If you never can remember if you have to use
5656 FurnitureTable, AssetTable or Table, or even TableNew for your
0 commit comments