[
https://issues.apache.org/jira/browse/LUCENE-4324?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=13440375#comment-13440375
]
Uwe Schindler commented on LUCENE-4324:
---------------------------------------
But inheriting docs from abstract base is allowed?
> extend checkJavaDocs.py to methods,constants,fields
> ---------------------------------------------------
>
> Key: LUCENE-4324
> URL: https://issues.apache.org/jira/browse/LUCENE-4324
> Project: Lucene - Core
> Issue Type: New Feature
> Components: general/build
> Reporter: Robert Muir
>
> We have a large amount of classes in the source code, its nice that we have
> checkJavaDocs.py to ensure packages and classes have some human-level
> description.
> But I think we need it for methods etc too. (it is also part of our
> contribution/style guidelines:
> http://wiki.apache.org/lucene-java/HowToContribute#Making_Changes)
> The reason is that like classes and packages, once we can enforce this in the
> build, people will quickly add forgotten documentation soon after their
> commit when its fresh in their mind.
> Otherwise, its likely to never happen.
--
This message is automatically generated by JIRA.
If you think it was sent incorrectly, please contact your JIRA administrators:
https://issues.apache.org/jira/secure/ContactAdministrators!default.jspa
For more information on JIRA, see: http://www.atlassian.com/software/jira
---------------------------------------------------------------------
To unsubscribe, e-mail: [email protected]
For additional commands, e-mail: [email protected]
