[GROOVY-7577] Groovy class docs all have ASF license as their explanation

• Type: Documentation
• Status: Closed
• Priority: Critical
• Resolution: Fixed
• Affects Version/s: 2.4.4
• Fix Version/s: 2.4.5
• External issue URL: http://docs.groovy-lang.org/2.4.4/html/gapi/index.html?groovy/lang/GroovyObjectSupport.html
• Assignee: Paul King
• Reporter: Aseem Bansal
• Created: 04/Sep/15 17:45
• Updated: 19/Oct/15 16:05
• Resolved: 04/Sep/15 22:47

Description

I opened one of groovy's API docs and noticed a weird thing. The only explanation that the class had is ASF license.

e.g.
http://docs.groovy-lang.org/2.4.4/html/gapi/index.html?groovy/lang/GroovyObjectSupport.html

I checked the source at https://github.com/apache/incubator-groovy/blob/master/src/main/groovy/lang/GroovyObjectSupport.java and found that there is some actual explanation but that is not present in the API docs.

So basically somehow the complete groovy API docs are missing a lot of information.

I opened http://docs.groovy-lang.org/2.4.4/html/gapi/groovy/lang/package-summary.html and saw that the description column contains the ASF license. Certainly nobody would expect that in an API documentation.

Now I am sure that this is not required by Apache software Foundation as I cross-checked in other Apache projects and they had some actual explanation.

It would be great if this is taken care of because in my opinion this just makes the API docs very bad.