There is nothing quite so helpful a

There is nothing quite so helpful and satisfying as a well-described public API. The javadocs
for the standard Java library are a case in point. It would be difficult, at best, to write
Java programs without them.
If you are writing a public API, then you should certainly write good javadocs for it.
But keep in mind the rest of the advice in this chapter. Javadocs can be just as misleading,
nonlocal, and dishonest as any other kind of comment.

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

มีสิ่งใดที่เป็นประโยชน์ค่อนข้างมาก และมีความสุขเป็น API สาธารณะการอธิบายดี Javadocsสำหรับไลบรารีมาตรฐานของ Java เป็นกรณีในจุด มันจะยาก ที่สุด การเขียนโปรแกรม Java ไม่ได้ถ้าคุณกำลังเขียน API สาธารณะ แล้วคุณควรแน่นอนเขียน javadocs ดีก็แต่เก็บไว้ในจิตใจของคำแนะนำในบทนี้ Javadocs ได้เพียงเป็นความเข้าใจผิดnonlocal และเป็นประเภทอื่น ๆ คิดไม่

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

ไม่มีอะไรที่ค่อนข้างเป็นประโยชน์และความพึงพอใจเป็นอย่างดีอธิบาย API สาธารณะ javadocs
สำหรับ Java ห้องสมุดมาตรฐานกรณีในจุด
มันจะเป็นเรื่องยากที่ดีที่สุดในการเขียนโปรแกรมจาวาโดยที่พวกเขา.
ถ้าคุณเขียนประชาชน API แล้วคุณแน่นอนควรเขียน javadocs ที่ดีสำหรับมัน.
แต่เก็บไว้ในใจส่วนที่เหลือของคำแนะนำในบทนี้ Javadocs สามารถเช่นเดียวกับความเข้าใจผิด
nonlocal และไม่น่าไว้วางใจเป็นชนิดอื่น ๆ ของการแสดงความคิดเห็น

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

ไม่มีอะไรที่ค่อนข้างเพื่อประโยชน์และความพึงพอใจเป็นอย่างดีอธิบาย API สาธารณะ . การ javadocs
สำหรับห้องสมุด Java มาตรฐานเป็นกรณีในจุด มันอาจจะยาก ที่ ดี ที่สุด เขียนโปรแกรมจาวา โดยพวกเขา
.
ถ้าคุณเขียน API สาธารณะแล้วคุณแน่นอนควรเขียนดี javadocs มัน .
แต่เก็บไว้ในใจส่วนที่เหลือของคำแนะนำในบทนี้ javadocs สามารถเช่นเดียวกับ
แฮ็กต่างถิ่น และทุจริต เช่นใดชนิดอื่น ๆของแสดงความคิดเห็น