principles:more_is_more_complex
Differences
This shows you the differences between two versions of the page.
Both sides previous revisionPrevious revisionNext revision | Previous revisionNext revisionBoth sides next revision | ||
principles:more_is_more_complex [2016-07-11 22:55] – documentation christian | principles:more_is_more_complex [2018-08-30 00:23] – [Strategies] 2a02:8108:9640:4455:f078:8679:7c4a:debc | ||
---|---|---|---|
Line 32: | Line 32: | ||
===== Rationale ===== | ===== Rationale ===== | ||
- | The capabilities of the human mind are certainly limited. If it is necessary to keep a large amount of modules or lines of code in mind, it is difficult to understand. Furthermore if a module is large, it takes a long time to read (and thus to comprehend). And if there are many modules, looking for a particular module takes a long time. And the longer the searching process takes, the more one will have forgotten what has been read previously. This results in worse readability, | + | The capabilities of the human mind are certainly limited. If it is necessary to keep a large amount of modules or lines of code in mind, it is difficult to understand. Furthermore if a module is large, it takes a long time to read (and thus to comprehend). And if there are many modules, looking for a particular module takes a long time. And the longer the searching process takes, the more one will have forgotten what has been read previously. This results in worse readability, |
Regarding documentation it is evident that smaller amounts of documentation are read faster. | Regarding documentation it is evident that smaller amounts of documentation are read faster. | ||
Line 42: | Line 42: | ||
* Merge several modules into one | * Merge several modules into one | ||
* Don't introduce a new module but put the functionality into another module | * Don't introduce a new module but put the functionality into another module | ||
- | * Avoid big modules | ||
- | * Divide large modules into several smaller ones | ||
- | * Introduce new modules to group related functionality. A [[patterns: | ||
===== Caveats ===== | ===== Caveats ===== |
principles/more_is_more_complex.txt · Last modified: 2021-10-20 21:26 by christian