Paket seviyesi Javadoc yorumlar oluşturmaya çalışırken, tercih edilen yöntem nedir? Sen ne yapıyorsun?

package-info.java

• Artıları
  • Daha yeni
• Eksileri
  • Sınıf Dersleri kötüye sadece yorumlar için kod için değil

package.html

• Artıları
  • HTML uzantısı değil, onun kod anlamına gelir
  • IDE sözdizimi vurgulama/metin editörleri
• Eksileri
  • Yok?

Benim için her zaman package.html kullandım. Ama doğru bir seçim olmadığını merak ediyorum.

package-info.java: "Bu dosyada yeni FIRSATLAR 5.0 ve package.html."—*tercih bitti 1*

Ek: büyük bir fark gibi görünüyorpaket ek açıklamalar. 7.4 Package Declarations gerekçesi yolunda biraz daha var.

Ek: ek açıklama özelliği de here here belirtilen.

Ek: ayrıca 5* *Bakın.