Chapter 5 - 編排
報紙的啟發
希望原始檔要跟報紙一樣,從上而下閱讀。上方會有頭條的敘述,讓你理解這段報導在談論些什麼,讓你可以決定如何閱讀。第一段通常會是整篇報導的概要,細節資訊會被隱藏。然後你在持續往下閱讀才會發現所有細節。
然後報紙本身也不會太長,所以原始檔盡量維持最多 200 ~ 500 行。
垂直空白區隔
每一個空白行會對眼睛下一個提示,讓其注意空白行後的第一行。通常用在一個概念接續另新的概念。
垂直密度
相依的函式盡量緊靠。
垂直順序
跟報紙一樣,應該是高層模組到低層模組。
水平的空白間隔
水平空白去強調運算子,下面是用空白強調加減法,以及乘法有較高的優先權所以沒有空白。
public class Quadratic {
public static double root1(double a, double b, double c) {
double determinant = determinant(a, b , c);
return (-b + Math.sqrt(determinant)) / (2*a);
}
public static double root2(double a, double b, double c) {
double determinant = determinant(a, b , c);
return (-b - Math.sqrt(determinant)) / (2*a);
}
private static double determinant(double a, double b, double c) {
return b*b - 4*a*c;
}
}
上一篇:
讀書心得 - Clean Code - Chapter 4