lucene-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From "Christine Poerschke (JIRA)" <>
Subject [jira] [Updated] (LUCENE-8115) fail precommit on unnecessary {@inheritDoc} use
Date Thu, 04 Jan 2018 10:11:00 GMT


Christine Poerschke updated LUCENE-8115:
    Attachment: LUCENE-8115-step2.patch

bq. ... do i have that correct?

Yes, you do. Attached patch clarifies the message associated with the check to _"\{@inheritDoc\}
on its own is unnecessary"_.

bq. I feel like i'm missing some context/background info here ...

The context here is that an automatic style check and enforcement like this seemed to me to
be a logical follow-on from [~dsmiley]'s [comment|]
on SOLR-11801 i.e. if tools can pick up on things like this then human code reviewers can
focus more on other things and/or code readers are not distracted by the unnecessary @inheritDoc
clutter and/or code writers are encouraged to add supplemental information alongside the @inheritDoc.

> fail precommit on unnecessary {@inheritDoc} use
> -----------------------------------------------
>                 Key: LUCENE-8115
>                 URL:
>             Project: Lucene - Core
>          Issue Type: Task
>            Reporter: Christine Poerschke
>            Assignee: Christine Poerschke
>            Priority: Minor
>         Attachments: LUCENE-8115-step2.patch, LUCENE-8115-step2.patch
> * Step 1: identify and remove existing unnecessary {{\{@inheritDoc\}}} use e.g. via IDE
tooling or {{git grep -C 1 inheritDoc}}.
> * Step 2: change {{ant validate}} so that precommit fails if/when any new unnecessary
{{\{@inheritDoc\}}} are introduced.

This message was sent by Atlassian JIRA

To unsubscribe, e-mail:
For additional commands, e-mail:

View raw message