Preface |
|
ix | |
|
|
1 | (10) |
|
1.1 What Is Maintainability? |
|
|
1 | (2) |
|
1.2 Why Is Maintainability Important? |
|
|
3 | (1) |
|
1.3 Three Principles of the Guidelines in This Book |
|
|
4 | (2) |
|
1.4 Misunderstandings About Maintainability |
|
|
6 | (1) |
|
1.5 Rating Maintainability |
|
|
7 | (2) |
|
1.6 An Overview of the Maintainability Guidelines |
|
|
9 | (2) |
|
2 Write Short Units of Code |
|
|
11 | (16) |
|
|
13 | (1) |
|
2.2 How to Apply the Guideline |
|
|
14 | (7) |
|
2.3 Common Objections to Writing Short Units |
|
|
21 | (3) |
|
|
24 | (3) |
|
3 Write Simple Units of Code |
|
|
27 | (14) |
|
|
32 | (1) |
|
3.2 How to Apply the Guideline |
|
|
33 | (4) |
|
3.3 Common Objections to Writing Simple Units of Code |
|
|
37 | (1) |
|
|
38 | (3) |
|
|
41 | (14) |
|
|
45 | (1) |
|
4.2 How to Apply the Guideline |
|
|
45 | (5) |
|
4.3 Common Objections to Avoiding Code Duplication |
|
|
50 | (3) |
|
|
53 | (2) |
|
5 Keep Unit Interfaces Small |
|
|
55 | (10) |
|
|
57 | (1) |
|
5.2 How to Apply the Guideline |
|
|
58 | (4) |
|
5.3 Common Objections to Keeping Unit Interfaces Small |
|
|
62 | (1) |
|
|
63 | (2) |
|
6 Separate Concerns in Modules |
|
|
65 | (12) |
|
|
69 | (1) |
|
6.2 How to Apply the Guideline |
|
|
70 | (3) |
|
6.3 Common Objections to Separating Concerns |
|
|
73 | (4) |
|
7 Couple Architecture Components Loosely |
|
|
77 | (12) |
|
|
78 | (4) |
|
7.2 How to Apply the Guideline |
|
|
82 | (2) |
|
7.3 Common Objections to Loose Component Coupling |
|
|
84 | (2) |
|
|
86 | (3) |
|
8 Keep Architecture Components Balanced |
|
|
89 | (8) |
|
|
91 | (1) |
|
8.2 How to Apply the Guideline |
|
|
92 | (2) |
|
8.3 Common Objections to Balancing Components |
|
|
94 | (1) |
|
|
94 | (3) |
|
9 Keep Your Codebase Small |
|
|
97 | (10) |
|
|
98 | (3) |
|
9.2 How to Apply the Guideline |
|
|
101 | (2) |
|
9.3 Common Objections to Keeping the Codebase Small |
|
|
103 | (4) |
|
|
107 | (16) |
|
|
109 | (1) |
|
10.2 How to Apply the Guideline |
|
|
110 | (9) |
|
10.3 Common Objections to Automating Tests |
|
|
119 | (2) |
|
|
121 | (2) |
|
|
123 | (10) |
|
|
123 | (1) |
|
11.2 How to Apply the Guideline |
|
|
124 | (6) |
|
11.3 Common Objections to Writing Clean Code |
|
|
130 | (3) |
|
|
133 | (2) |
|
12.1 Turning the Guidelines into Practice |
|
|
133 | (1) |
|
12.2 Lower-Level (Unit) Guidelines Take Precedence Over Higher-Level (Component) Guidelines |
|
|
133 | (1) |
|
12.3 Remember That Every Commit Counts |
|
|
134 | (1) |
|
12.4 Development Process Best Practices Are Discussed in the Follow-Up Book |
|
|
134 | (1) |
A How SIG Measures Maintainability |
|
135 | (4) |
Index |
|
139 | |