При попытке создать комментарии Javadoc на уровне пакетов, какой предпочтительный метод? Что вы делаете?
package-info.java
- Pros
- Новые
- Cons
- Злоупотребление классом - Классы предназначены для кода, а не только для комментариев
package.html
- Pros
- Расширение HTML означает его не код
- Выделение синтаксиса в редакторах IDE/текстовых редакторах
- Cons
- None
Для меня я всегда использовал Package.html. Но мне интересно, правильный ли выбор.