I don't want to add unopened issues, so I'll make my case, then close it. If anyone else sees it
from the GraalVM / Oracle Team then this is great; if not then this is also fine.
Recently I looked at the docs for Java Swing at oracle:
These are, I believe, a bit outdated, and I think they also no longer receive any updates.
Now here I was thinking ... what if all the API documentation about Java and the general
Java infrastructure, as far as GraalVM and Oracle and openjkd etc... is concerned, could
be bundled into ONE resource? I'd suggest GraalVM because the docs at GraalVM are
best. But the idea could be that slowly and steadily, documentation may be ported
over towards GraalVM. Perhaps with the help of more people, and if they make smaller
changes too (does not need to port EVERYTHING in a single day, could be all little
steps).
This would require, however had, a bit of coordination, kind of like a documentation-master,
whose task is to make the documentation in general great, starting from GraalVM (which
already has very good documentation).
Anyway. Perhaps my suggestion right now does not convince many, but who knows, in
a few years, perhaps documentation could be one super-strong focus over the whole
Java ecosystem. Right now information is a bit spread out all over the place, and it takes
quite some time to find all that is useful. This is why I think one central site would be
nice (oracle's homepage is a bit too static, which is why I think a team would require to
be able to move quickly and rapidly, to make changes, rather than a slow, long tedious
process that fatigues people out and away from contribution).
I don't want to add unopened issues, so I'll make my case, then close it. If anyone else sees it from the GraalVM / Oracle Team then this is great; if not then this is also fine.
Recently I looked at the docs for Java Swing at oracle:
https://docs.oracle.com/javase/tutorial/uiswing/
These are, I believe, a bit outdated, and I think they also no longer receive any updates.
Now here I was thinking ... what if all the API documentation about Java and the general Java infrastructure, as far as GraalVM and Oracle and openjkd etc... is concerned, could be bundled into ONE resource? I'd suggest GraalVM because the docs at GraalVM are best. But the idea could be that slowly and steadily, documentation may be ported over towards GraalVM. Perhaps with the help of more people, and if they make smaller changes too (does not need to port EVERYTHING in a single day, could be all little steps).
This would require, however had, a bit of coordination, kind of like a documentation-master, whose task is to make the documentation in general great, starting from GraalVM (which already has very good documentation).
Anyway. Perhaps my suggestion right now does not convince many, but who knows, in a few years, perhaps documentation could be one super-strong focus over the whole Java ecosystem. Right now information is a bit spread out all over the place, and it takes quite some time to find all that is useful. This is why I think one central site would be nice (oracle's homepage is a bit too static, which is why I think a team would require to be able to move quickly and rapidly, to make changes, rather than a slow, long tedious process that fatigues people out and away from contribution).