Javadoc: package.html или package-info.java

При попытке создания комментариев Javadoc уровня пакета какой метод предпочтительнее? Что вы делаете?

package-info.java

• Плюсы
  • Новые
• Против
  • Злоупотребление классом - классы для кода, а не только для комментариев

package.html

• Плюсы
  • Расширение HTML означает отсутствие кода
  • Подсветка синтаксиса в IDE / текстовых редакторах
• Минусы
  • Нет?

Для меня я всегда использовал Package.html. Но мне интересно, если это правильный выбор.