JDK documentation

[Mark Thornton]

Debra Scott wrote:
> Hi All,
>
> I'd like to get people's thoughts on the documentation
> for the JDK platform.
>
> * How many people feel it is important for the the docs to be open
>    sourced so the community can contribute to them?
I think this would be very valuable.
>
>
>  * How many people have seen at least one occasion
>    where they would have added something to the
>    documentation, or made a correction, if they
>    had been able? (a large or small percentage?)
There are numerous changes many small, some more substantial that I 
might have made. As it is some exist as comments to bugs on the bug 
parade (and have been referenced by the evaluation).

A particular flaw in the current documentation is the poor (often 
non-existent) documenting of platform specific behaviour. Some people 
seem very clear that this information should go somewhere else, without 
doing anything to ensure that a suitable other place is created and 
populated.


Mark Thornton