docs: clarify describe.skip behaviour (#12383)

docs/GlobalAPI.md

@@ -398,7 +398,7 @@ test('will not be ran', () => {
 
 Also under the alias: `xdescribe(name, fn)`
 
-You can use `describe.skip` if you do not want to run a particular describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-25.x/GlobalAPI.md

@@ -374,7 +374,7 @@ test('will not be ran', () => {
 
 Also under the alias: `xdescribe(name, fn)`
 
-You can use `describe.skip` if you do not want to run a particular describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe('my beverage', () => {
@@ -392,7 +392,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-26.x/GlobalAPI.md

@@ -374,7 +374,7 @@ test('will not be ran', () => {
 
 Also under the alias: `xdescribe(name, fn)`
 
-You can use `describe.skip` if you do not want to run a particular describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe('my beverage', () => {
@@ -392,7 +392,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-27.0/GlobalAPI.md

@@ -331,7 +331,7 @@ describe.each`
 
 Also under the alias: `fdescribe(name, fn)`
 
-You can use `describe.only` if you want to run only one describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe.only('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-27.1/GlobalAPI.md

@@ -398,7 +398,7 @@ test('will not be ran', () => {
 
 Also under the alias: `xdescribe(name, fn)`
 
-You can use `describe.skip` if you do not want to run a particular describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-27.2/GlobalAPI.md

@@ -331,7 +331,7 @@ describe.each`
 
 Also under the alias: `fdescribe(name, fn)`
 
-You can use `describe.only` if you want to run only one describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe.only('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-27.4/GlobalAPI.md

@@ -331,7 +331,7 @@ describe.each`
 
 Also under the alias: `fdescribe(name, fn)`
 
-You can use `describe.only` if you want to run only one describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe.only('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`
 

website/versioned_docs/version-27.5/GlobalAPI.md

@@ -331,7 +331,7 @@ describe.each`
 
 Also under the alias: `fdescribe(name, fn)`
 
-You can use `describe.only` if you want to run only one describe block:
+You can use `describe.skip` if you do not want to run the tests of a particular `describe` block:
 
 ```js
 describe.only('my beverage', () => {
@@ -416,7 +416,7 @@ describe.skip('my other beverage', () => {
 });
 ```
 
-Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests.
+Using `describe.skip` is often a cleaner alternative to temporarily commenting out a chunk of tests. Beware that the `describe` block will still run. If you have some setup that also should be skipped, do it in a `beforeAll` or `beforeEach` block.
 
 ### `describe.skip.each(table)(name, fn)`