| Re: [cross-project-issues-dev] Disk usage report for Hudson/Build |
|
On 12/13/2012 10:57 AM, Aleksandar
Kurtakov wrote:
What about if one needs to provide real browsable javadoc as platform does it?If you want HTML JavaDoc, then generate JavaDoc. If you want just JavaDoc in Content Assist, then shipping sources does that. If a project provides or at least try to provide an API that others can use to extend it relying on source bundles is not sufficient as people need to look at the API to get an idea how things are supposed to work and what the framework is capable of doing prior to starting to write code.IMO, HTML JavaDoc has never helpful when it comes to having ideas of things are supposed to work. Tutorials and real documentation are way better. And when it comes to developing using an API content assist is what i want. When it comes to understanding something strange, source is the most helpful documentation. So I would say that in my daily use-cases, I don't have need at all for browsable JavaDoc. But your mileage may vary. Cheers, |