Skip to content
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

Merged
merged 4 commits into from Mar 29, 2022

Conversation

mocobeta
Copy link
Contributor

@mocobeta mocobeta commented Mar 28, 2022

To see how it looks, you can check the preview https://github.com/mocobeta/lucene/tree/lucene-10184.

@mocobeta mocobeta marked this pull request as ready for review March 28, 2022 02:07
@mocobeta
Copy link
Contributor Author

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`.
Copy link
Contributor

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.

Copy link
Contributor Author

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.
Copy link
Contributor

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.

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this section was removed.

Copy link
Contributor

@dweiss dweiss left a 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/
Copy link
Contributor Author

@mocobeta mocobeta Mar 29, 2022

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.

Copy link
Contributor

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.

@mocobeta mocobeta merged commit ac6c36d into apache:main Mar 29, 2022
@mocobeta mocobeta deleted the lucene-10184 branch March 29, 2022 07:52
@mocobeta
Copy link
Contributor Author

Merged. Thank you for your feedback.

wjp719 added a commit to wjp719/lucene that referenced this pull request Apr 5, 2022
* 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)
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants