In Listing 3-7 I changed the name o

In Listing 3-7 I changed the name of our example function from testableHtml to
SetupTeardownIncluder.render. This is a far better name because it better describes what
the function does. I also gave each of the private methods an equally descriptive name
such as isTestable or includeSetupAndTeardownPages. It is hard to overestimate the value
of good names. Remember Ward’s principle: “You know you are working on clean code
when each routine turns out to be pretty much what you expected.” Half the battle to
achieving that principle is choosing good names for small functions that do one thing.
The smaller and more focused a function is, the easier it is to choose a descriptive
name.
Don’t be afraid to make a name long. A long descriptive name is better than a short
enigmatic name. A long descriptive name is better than a long descriptive comment. Use
a naming convention that allows multiple words to be easily read in the function names,
and then make use of those multiple words to give the function a name that says what
it does.

ผลลัพธ์ (ไทย) 1:

ในรายการ 3-7 ผมเปลี่ยนชื่อของฟังก์ชันตัวอย่างของเราจาก testableHtml ไปSetupTeardownIncluder.render. นี้เป็นชื่อดี เพราะมันดีกว่าอธิบายอะไรการทำงานไม่ ผมยังให้วิธีส่วนตัวเท่า ๆ กันชื่อเช่น isTestable หรือ includeSetupAndTeardownPages ยากควรเลือกค่าชื่อดี จำได้ว่า หลักการของผู้ป่วย: "คุณรู้ว่า คุณกำลังใช้งานรหัสสะอาดเมื่อแต่ละขั้นตอนจะออกมาสวยมากสิ่งที่คุณคาดไว้" ครึ่งหนึ่งการต่อสู้เพื่อบรรลุหลักการที่จะเลือกชื่อที่ดีสำหรับฟังก์ชั่นเล็ก ๆ ที่ทำสิ่งหนึ่งมีขนาดเล็ก และเน้นมากคือฟังก์ชัน มีให้เลือกมีคำอธิบายชื่อไม่ต้องกลัวทำชื่อยาว ชื่อยาวจะดีกว่าสั้นชื่อลึกลับ ชื่อยาวจะดีกว่าความคิดเห็นอธิบายยาว ใช้การตั้งชื่อให้หลายคำที่อ่านได้ง่ายในชื่อของฟังก์ชันแล้ว ทำให้ใช้คนหลายคำเพื่อให้ฟังก์ชันชื่อว่าอะไรมันไม่

ผลลัพธ์ (ไทย) 2:

ในรายการ 3-7 ผมเปลี่ยนชื่อของฟังก์ชั่นตัวอย่างของเราจากการ testableHtml
SetupTeardownIncluder.render นี้เป็นชื่อที่ดีกว่าเพราะมันอธิบายถึงสิ่งที่ดีกว่า
ฟังก์ชั่นไม่ ฉันยังให้แต่ละวิธีเอกชนชื่อที่สื่อความหมายอย่างเท่าเทียมกัน
เช่น isTestable หรือ includeSetupAndTeardownPages มันเป็นเรื่องยากที่จะประเมินค่า
ของชื่อที่ดี โปรดจำไว้ว่าหลักการของวอร์ด: "คุณรู้ว่าคุณกำลังทำงานเกี่ยวกับรหัสสะอาด
เมื่อแต่ละประจำจะเปิดออกจะสวยมากสิ่งที่คุณคาดว่า." ครึ่งต่อสู้เพื่อ
บรรลุหลักการที่ว่าคือการเลือกชื่อที่ดีสำหรับฟังก์ชั่นขนาดเล็กที่ทำสิ่งหนึ่ง.
ที่มีขนาดเล็กและอื่น ๆ มุ่งเน้นฟังก์ชั่นได้ง่ายขึ้นก็คือการเลือกพรรณนา
ชื่อ.
อย่ากลัวที่จะทำให้ชื่อยาว ชื่อที่อธิบายยาวจะดีกว่าสั้น
ชื่อลึกลับ ชื่อที่อธิบายยาวจะดีกว่าการแสดงความคิดเห็นเป็นคำอธิบายยาว ใช้
การประชุมตั้งชื่อที่ช่วยให้คำหลายคำที่จะอ่านได้อย่างง่ายดายในชื่อฟังก์ชั่น
แล้วทำให้การใช้คำหลาย ๆ คำเหล่านั้นเพื่อให้ฟังก์ชั่นชื่อที่กล่าวว่าสิ่งที่
มันไม่

ผลลัพธ์ (ไทย) 3:

ในรายการที่ 3-7 ผมเปลี่ยนชื่อจาก testablehtml กับฟังก์ชันตัวอย่างของเราsetupteardownincluder.render . นี่เป็นชื่อดีกว่า เพราะมันน่าจะอธิบายว่าหน้าที่แล้ว ผมก็ให้ของแต่ละส่วนบุคคลวิธีการชื่อพรรณนาเท่าๆ กันเช่น istestable หรือ includesetupandteardownpages . มันเป็นเรื่องยากที่จะประเมินมากเกินไป ค่าชื่อดี จำได้ว่าหลักการของผู้ป่วย : " คุณจะรู้ว่าคุณกำลังทำงานกับรหัสที่สะอาดเมื่อแต่ละขั้นตอนจะเปิดออกจะสวยมากสิ่งที่คุณคาดหวัง " ครึ่งรบการบรรลุหลักการคือการเลือกชื่อที่ดีสำหรับขนาดเล็ก ฟังก์ชันที่ทำสิ่งหนึ่งขนาดเล็กและเน้นมากขึ้น ฟังก์ชั่น คือ ง่าย มันคือการเลือกบรรยายชื่ออย่ากลัวที่จะทําชื่อยาว ชื่อยาวดีกว่าสั้นเชิงพรรณนาทํานายชื่อ ชื่อยาวดีกว่า ยาว บรรยายพรรณนาแสดงความคิดเห็น ใช้การตั้งชื่ออนุสัญญาที่ช่วยให้หลายคำได้อย่างง่ายดายอ่านฟังก์ชันชื่อและจากนั้นให้ใช้คำเหล่านั้นหลายเพื่อให้ฟังก์ชันชื่อว่าอะไรมันไม่