面对现实吧：没必要是一名设计师，也能看出默认的文档看起来很丑陋。
尽管网上有一些重新样式化的 文档资源，但默认行为应该代表产品，并且应该是相当好看的。
另一个问题是，与其他类似资源相比，的可用性已经不再更新。
特别是在使用Firefox的快速搜索时，非常大型的项目难以导航。
实践问题：
是否有任何独立的（桌面）应用程序，能够以比浏览器更易用的方式浏览现有的文档？
我正在思考像Mono的文档浏览器那样的东西。
理论问题：
有人知道是否有计划以某种标准化的方式发展文档呢？
编辑：这个主题的Sun'维基链接很有用。
我创建了一个Markdown (Java) Doclet，它可以将Markdown格式的源代码注释转换为相同的HTML Javadocs文档。
这个新的Doclet还会对文本进行一些重新设计，但是在此阶段生成的HTML没有发生改变。
这在一定程度上解决了HTML在Java注释中存在的问题，这可能是当前Javadoc最大的可用性问题。
我认为Javadoc的概念并不过时。据我所知，这些概念是多年前根植于一种名为doxygen的产品中的，该产品仍可用于其他语言（例如Objective-C，在该语言中它被广泛使用）。即使如此，它也有其前身 - 看看Donald Knuth用来创建TeX的编程环境（文学编程）。
尽管如此，拥有单一的源代码和文档非常吸引人。
除此之外，使用JavaDoc工具支持的插件系统可以定制文档的呈现方式，以满足您特定的需求。您可以提供一个插件（就像我们做的那样），将其直接发布到可以通过Web直接访问的数据库中。使用协作，任何人都可以提供其他评论或澄清信息，这些信息可能会回流到原始源代码中。
Javadoc是我见过的最好的源代码自动生成文档系统。其中很大一部分原因是它非常简单 - 即使我想用5年前的手机浏览javadocs也可以！虽然我同意有必要进行一些改进，特别是JDK浏览起来很麻烦，但我不敢完全重新发明轮子，因为我们目前拥有的是一种RESTful、易于使用的解决方案，可以在几乎任何地方使用。
http://download.oracle.com/javase/6/docs/api/java/lang/String.html#String(byte[])）使用了括号、方括号和其他不允许的字符，因此它们是无效的。这会导致在某些浏览器中无法正常显示。 - Joey我最近收到一封Sun公司正在改进Javadoc HTML输出的邮件转发。该邮件内容如下：
我们正在提议改进JDK7的javadoc/doclet。项目维基页面位于 http://wikis.sun.com/display/Javadoc/Home。作为建议的改进的一部分，将改进javadoc输出的用户界面。新设计的屏幕截图已上传至项目维基。 javadoc输出标记语言将被修改为有效的HTML和WCAG 2.0兼容。
因此，该项目仍在进行中，尽管有些晚了。然而，在我看来，Javadoc最大的缺点之一是它与HTML紧密耦合。许多类的Javadoc包括字面HTML，并依赖于输出也是HTML格式。这很不幸，但我认为这不会改变。尽管如此，这意味着开发人员可以在其中包含任何他们想要的无效、非规范等问题的HTML内容。因此，调整javadoc工具的输出只是其中的一部分，另一部分则不会和不能改变，因此仍然存在。
至于浏览文档，我也觉得HTML文档有些笨重。我通常使用Eclipse中的Javadoc视图。它也有缺点（速度慢，搜索功能不太好），但对于大多数事情来说已经足够了。
个人认为Javadoc仍然非常有用，尤其是它标准化了。我不知道有哪种主要的文档风格更容易导航（这可能非常主观，但是例如我个人发现MSDN很难使用）。
对于搜索：使用Javadoc Search Frame，它使所有类型的Javadoc使用变得更加容易。它作为Firefox用户脚本和Google Chrome扩展可用。
有一个DocBook文档生成器。相比于(X)HTML，DocBook是一种更丰富的文档类型，更适合描述技术内容。从DocBook源代码中，您可以生成各种不同的输出格式。
我个人希望有一个比HTML（因此标签繁琐）的JavaDoc更易读的“注释文档”标准。
例如，像这里使用的MarkDown将是非常好的选择，它在源代码中易于阅读，在源代码外部也可以很好地格式化。
在当前的JavaDoc中，我想象许多人会使用JavaDoc注释，但实际上并没有充分记录所需的内容。我相信每个人都曾浏览过API在线JavaDoc，而该文档未经记录或仅有少量记录，因此比应该更难使用。
这并没有得到代码重构工具（例如Eclipse内部或源代码提交后）的帮助，这些工具会完全破坏您可能在JavaDoc注释中放置的任何可读结构（例如，项目列表），转换为一个大的文本块，除非您真正使用两个回车符，否则无法实现您需要使用的换行）。