-
Notifications
You must be signed in to change notification settings - Fork 1.1k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
LUCENE-10184: add CONTRIBUTING.md; reorganize README. #771
Conversation
would anyone want to review this... i'll wait until tomorrow then merge it (if there are no objections). |
CONTRIBUTING.md
Outdated
|
||
### Unit tests | ||
|
||
Please make sure that all unit tests succeed before constructing your patch: `./gradlew test`. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think it'd be good to run check instead of just test. We have so many validation checks that just the test alone won't do.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Changed this section to encourage to use "gradlew check".
https://github.com/mocobeta/lucene/blob/lucene-10184/CONTRIBUTING.md#checks
CONTRIBUTING.md
Outdated
|
||
### Precommit | ||
|
||
Please run `./gradlew precommit` to identify problems that should be addressed before you contribute your changes. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Use "gradlew check" here. I'd be willing to phase out the non-convention "precommit" at some point.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
this section was removed.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Looks good to me. I'd edit some minor things while we're looking at this - comments attached.
|
||
Patches should be attached to an issue in Jira. | ||
|
||
To enable automatic validation of Jira patches, switch the issue's status to "Patch Available" by clicking on the "Enable Patch Review" button near the top of the page. This will enqueue an ASF Jenkins job PreCommit-LUCENE-Build to run various quality checks on the patch and post a validation report as a comment (by "Lucene/Solr QA") on the issue. Expect a delay of 12 hours or so before the patch validation job actually runs. Note that in order for a patch file to trigger validation, its name must conform to the naming rules outlined here: https://yetus.apache.org/documentation/in-progress/precommit-patchnames/ |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
note: I noticed the link to Yetus documentation is not available but couldn't find the moved page or alternative. I'm not sure what should we do on it, I'd defer the decision here.
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I've no idea too.
Merged. Thank you for your feedback. |
* main: LUCENE-10456: Implement Weight#count for MultiRangeQuery (apache#731) LUCENE-10484: Move CHANGES entry to 9.2. LUCENE-10484: Add support for concurrent facets random sampling (apache#765) LUCENE-10002: Replaces usages of FacetsCollector with FacetsCollectorManager (apache#764) LUCENE-10466: Move changelog entry to 9.2 LUCENE-10466: Ensure IndexSortSortedNumericDocValuesRangeQuery handles sort types besides LONG LUCENE-10498: don't count num hits nor accumulate scores unless necessary (apache#782) LUCENE-10184: mention of opening a Jira issue (apache#781) Update link to contribution guide Remove redundant index (apache#776) Implement method to bulk add all collection elements to a PriorityQueue (apache#770) LUCENE-10491: Fix correctness bug in TaxonomyFacetSumValueSource score providing (apache#775) Replace usages of search(Query, Collector) in CheckHits (apache#763) LUCENE-10002: Add FixedBitSetCollector and corresponding collector manager to test framework (apache#766) LUCENE-10475: Merge o.a.l.a.[ja|ko].util into o.a.l.a.[ja|ko].dict (apache#772) LUCENE-10184: add CONTRIBUTING.md; reorganize README. (apache#771) Add CHANGES entry for LUCENE-10325 LUCENE-10325: Add getTopDims functionality to Facets (apache#747)
CONTRIBUTING.md
; this is based on https://cwiki.apache.org/confluence/display/lucene/HowToContributeBuilding with Gradle
section in the README to CONTRIBUTING.md.To see how it looks, you can check the preview https://github.com/mocobeta/lucene/tree/lucene-10184.