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

TESTING.asciidoc fix examples using forbidden annotation #34515

Merged
merged 2 commits into from
Oct 23, 2018

Conversation

lipsill
Copy link
Contributor

@lipsill lipsill commented Oct 16, 2018

@Nightly has been added to the forbidden test annotations :

org.apache.lucene.util.LuceneTestCase$Nightly @ We don't run nightly tests at this point!

guaranteeing that no tests can be annotated as @Nightly.

This PR removes any examples containing @Nightly, so that contributors do not try to implement, filter or run nightly tests.

Clean up examples not to use forbidden test annotation `@Nightly`.
TESTING.asciidoc Outdated
@@ -91,23 +91,22 @@ Run any test methods that contain 'esi' (like: ...r*esi*ze...).

You can also filter tests by certain annotations ie:

* `@Nightly` - tests that only run in nightly builds (disabled by default)
* `@Backwards` - backwards compatibility tests (disabled by default)
Copy link
Member

Choose a reason for hiding this comment

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

We don't actually use @Backwards or @BadApple either! At this point we really only use @AwaitsFix I think.

Copy link
Contributor Author

Choose a reason for hiding this comment

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

I left the @BadApple and @Backwards so that the filtering examples with more complicated boolean operators and grouping are valid. But you are right, as only @AwaitsFix is still used, the other annotations should be removed as well.

I was thinking to remove the @Backwards separately as there is also a section using the backwards filtering which I guess is outdated: https://github.com/elastic/elasticsearch/blob/ad26075e989de81df61ec9f2eabce2bbc00a4896/TESTING.asciidoc#backwards-compatibility-tests
and should be replaced by:
https://github.com/elastic/elasticsearch/blob/ad26075e989de81df61ec9f2eabce2bbc00a4896/TESTING.asciidoc#testing-backwards-compatibility
I simply did not want to mix it all together ;)

Just let me know if you prefer having the changes at the same PR or several dedicated ones ;)

Copy link
Member

Choose a reason for hiding this comment

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

How would you feel about removing the complex filtering examples in this PR because, not that we really only have the one annotation, we really can only document the one filter and then doing a separate PR for @Backwards like you say?

Copy link
Contributor

Choose a reason for hiding this comment

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

@lipsill I addressed the outdated section in #34050 already.

@colings86 colings86 added >docs General docs changes :Delivery/Build Build or test infrastructure labels Oct 17, 2018
@elasticmachine
Copy link
Collaborator

Pinging @elastic/es-core-infra

@rjernst
Copy link
Member

rjernst commented Oct 23, 2018

Thanks for bringing his up to date with the request changes @lipsill. Note that is it best to ping on the PR when you push changes, as not everyone follows all changes to PRs, but only comments.

This LGTM

@elasticmachine ok to test

@alpar-t alpar-t merged commit 4bda9bd into elastic:master Oct 23, 2018
alpar-t pushed a commit that referenced this pull request Oct 23, 2018
Clean up examples not to use forbidden test annotation `@Nightly`.
remove references to unused annotations
jasontedor added a commit to jasontedor/elasticsearch that referenced this pull request Oct 23, 2018
* master: (24 commits)
  ingest: better support for conditionals with simulate?verbose (elastic#34155)
  [Rollup] Job deletion should be invoked on the allocated task (elastic#34574)
  [DOCS] .Security index is never auto created (elastic#34589)
  CCR: Requires soft-deletes on the follower (elastic#34725)
  re-enable bwc tests (elastic#34743)
  Empty GetAliases authorization fix (elastic#34444)
  INGEST: Document Processor Conditional (elastic#33388)
  [CCR] Add total fetch time leader stat (elastic#34577)
  SQL: Support pattern against compatible indices (elastic#34718)
  [CCR] Auto follow pattern APIs adjustments (elastic#34518)
  [Test] Remove dead code from ExceptionSerializationTests (elastic#34713)
  A small typo in migration-assistance doc (elastic#34704)
  ingest: processor stats (elastic#34724)
  SQL: Implement IN(value1, value2, ...) expression. (elastic#34581)
  Tests: Add checks to GeoDistanceQueryBuilderTests (elastic#34273)
  INGEST: Rename Pipeline Processor Param. (elastic#34733)
  Core: Move IndexNameExpressionResolver to java time (elastic#34507)
  [DOCS] Force Merge: clarify execution and storage requirements (elastic#33882)
  TESTING.asciidoc fix examples using forbidden annotation (elastic#34515)
  SQL: Implement `CONVERT`, an alternative to `CAST` (elastic#34660)
  ...
@lipsill lipsill deleted the patch-3 branch October 24, 2018 11:25
kcm pushed a commit that referenced this pull request Oct 30, 2018
Clean up examples not to use forbidden test annotation `@Nightly`.
remove references to unused annotations
@mark-vieira mark-vieira added the Team:Delivery Meta label for Delivery team label Nov 11, 2020
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
:Delivery/Build Build or test infrastructure >docs General docs changes Team:Delivery Meta label for Delivery team v6.5.0 v7.0.0-beta1
Projects
None yet
Development

Successfully merging this pull request may close these issues.

7 participants