Bazel 'test' options not clearly findable

[EricBurnett]

Description of the problem / feature request:

Bazel 'test' behaviour and options are not clearly documented. Specifically, the fact that bazel test builds all non-test targets by default is only documented under a 'miscellaneous' flag.

Feature requests: what underlying problem are you trying to solve with this feature?

1. Categorize 'Miscellaneous options' so that they show up in appropriate sections. Namely, https://docs.bazel.build/versions/master/command-line-reference.html#test should include --[no]build_tests_only , --flaky_test_attempts, and other such test-specific flags. Most of the rest should be categorized as well.

2. A page about tests might also be appropriate. https://docs.bazel.build/versions/master/test-encyclopedia.html has the technical specifications, but I cannot find a page that clearly documents the basics - when you'll run bazel test and what it does. Nothing linked off of https://docs.bazel.build/versions/master/getting-started.html appears to talk about testing.

Bugs: what's the simplest, easiest way to reproduce this bug? Please provide a minimal example if possible.

N/A

What operating system are you running Bazel on?

N/A

What's the output of bazel info release?

N/A

Have you found anything relevant by searching the web?

Searching the web finds misleading answers, e.g. a cursory read of #4257 (first link from "bazel build all targets") implies that "bazel test //... && bazel build //..." is a reasonable pattern, when it's actually an antipattern.

This would presumably be mitigated if there were clear answers in bazel documentation proper.

[jmmv]

I don't think this belongs to "local execution" and is more of an issue documenting general command line behavior. Moving to the Xproduct team, which apparently covers this topic.

[github-actions]

Thank you for contributing to the Bazel repository! This issue has been marked as stale since it has not had any activity in the last 1+ years. It will be closed in the next 90 days unless any other activity occurs. If you think this issue is still relevant and should stay open, please post any comment here and the issue will no longer be marked as stale.