kriegaex commented on issue #46:
URL: https://github.com/apache/groovy-website/issues/46#issuecomment-5739080301
@paulk-asert Thank you, I am just now taking a cursory glance at the new
auto-generated docs, dropping a few notes here while I am looking into
`tabbedPane`, because it is what I used as an example to point to the old docs
found at archive.org:
* There is a lot of information about widgets and attributes, which is good.
* The first thing I noticed is a broken link to the Java API docs:
* The link is
https://docs.oracle.com/en/java/javase/17/docs/api/index.html?javax/swing/JTabbedPane.html,
* but should be
https://docs.oracle.com/en/java/javase/17/docs/api/java.desktop/javax/swing/JTabbedPane.html.
* The properties list makes no difference between properties specific to the
class and inherited ones. It would be nice to have them grouped, listing more
specific ones first and those further up the hierarchy last.
* The "Readable" and "Writable" columns in the table are empty, which looks
like a bug and rather creates confusion for the reader than helping her.
* The class names in the "Type" column of the table are not linked to their
respective Java API docs pages.
* There is no sample code like in the old documentation.
* There is no clue concerning which other elements - e.g. `panel`, `label` -
can be embedded in the documented widget.
While it is probably not straightforward to auto-generate example code (even
though I could envision such a thing), all other issues listed above should be
able to be auto-generated.
P.S.: Was it a good idea to close the issue without waiting for some user
feedback first?
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
