mishaDova opened a new issue, #49:
URL: https://github.com/apache/groovy-website/issues/49

                 @jagedn, yeah, I know they are there, but I was talking about 
discoverability. If I already know what I am searching for and start typing a 
widget name, I can spot them. Otherwise, just pressing `Ctrl`+`Space`, I see an 
overwhelming number of options - constants, Groovy API etc. - and can scroll 
down the list for minutes. Also, even if I find what I want, `Ctrl-Q` does not 
show any helpful documentation:
   
   
![image](https://github.com/apache/groovy-website/assets/1537384/6bb24258-1cff-496b-84a8-c159d2710f85)
   
   
![image](https://github.com/apache/groovy-website/assets/1537384/10e26eba-cb61-46b0-a56f-30f0ff4825c7)
   
   
![image](https://github.com/apache/groovy-website/assets/1537384/a605f25c-8829-47b9-a62e-40a8ce3eccf1)
   
   Well, yeah, so now I know that all those methods have `java.util.Map 
attributes` arguments lists.
   
   Then, inside an arguments list, it is similar. If I just want to see which 
options there are at all via `Ctrl`+`Space`, I need to spot the ones with a 
trailing colon while scrolling the list. This is all feasible, but not very 
nice. Maybe I should rather blame the IDE or my lack of knowledge about how to 
optimally configure IntelliSense in IntelliJ IDEA, but it does not make things 
easier. The named parameters also have no documentation I could open with 
`Ctrl-Q`:
   
   
![image](https://github.com/apache/groovy-website/assets/1537384/16b8a0db-bf0e-471c-a615-de7e06242e7d)
   
   This is why I opened this issue in order to bring back some helpful, 
old-school API description for all widgets and their options into the Groovy 
documentation. If widget, option and especially documentation (Javadoc, 
Groovydoc) discoverability in my IDE was adequate, I would maybe not need that. 
But for now, I do.
   
   _Originally posted by @kriegaex in 
https://github.com/apache/groovy-website/issues/46#issuecomment-1754197985_
               


-- 
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: dev-unsubscr...@groovy.apache.org.apache.org

For queries about this service, please contact Infrastructure at:
us...@infra.apache.org

Reply via email to