mthornton at optrak.co.uk
Thu Jan 10 01:04:35 PST 2008
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
More information about the discuss