docs(prefer-hooks-on-top): improve code example

Author: G-Rath

docs/rules/prefer-hooks-on-top.md

@@ -11,47 +11,49 @@ Examples of **incorrect** code for this rule
 
 describe('foo', () => {
   beforeEach(() => {
-    //some hook code
+    seedMyDatabase();
   });
-  test('bar', () => {
-    some_fn();
-  });
-  beforeAll(() => {
-    //some hook code
-  });
-  test('bar', () => {
-    some_fn();
+
+  it('accepts this input', () => {
+    // ...
   });
-});
 
-// Nested describe scenario
-describe('foo', () => {
   beforeAll(() => {
-    //some hook code
+    createMyDatabase();
   });
-  test('bar', () => {
-    some_fn();
+
+  it('returns that value', () => {
+    // ...
   });
-  describe('inner_foo', () => {
+
+  describe('when the database has specific values', () => {
     beforeEach(() => {
-      //some hook code
+      seedMyDatabase('specific-fixture');
+    });
+
+    it('accepts that input', () => {
+      // ...
     });
-    test('inner bar', () => {
-      some_fn();
+
+    it('throws an error', () => {
+      // ...
     });
-    test('inner bar', () => {
-      some_fn();
+
+    afterEach(() => {
+      clearMyFixture('specific-fixture');
     });
     beforeAll(() => {
-      //some hook code
+      createMyFixture('specific-fixture');
     });
-    afterAll(() => {
-      //some hook code
-    });
-    test('inner bar', () => {
-      some_fn();
+
+    it('logs a message', () => {
+      // ...
     });
   });
+
+  afterAll(() => {
+    clearMyDatabase();
+  });
 });
 ```
 
@@ -61,35 +63,49 @@ Examples of **correct** code for this rule
 /* eslint jest/prefer-hooks-on-top: "error" */
 
 describe('foo', () => {
-  beforeEach(() => {
-    //some hook code
+  beforeAll(() => {
+    createMyDatabase();
   });
 
-  // Not affected by rule
-  someSetup();
-
-  afterEach(() => {
-    //some hook code
+  beforeEach(() => {
+    seedMyDatabase();
   });
-  test('bar', () => {
-    some_fn();
+
+  afterAll(() => {
+    clearMyDatabase();
   });
-});
 
-// Nested describe scenario
-describe('foo', () => {
-  beforeEach(() => {
-    //some hook code
+  it('accepts this input', () => {
+    // ...
   });
-  test('bar', () => {
-    some_fn();
+
+  it('returns that value', () => {
+    // ...
   });
-  describe('inner_foo', () => {
+
+  describe('when the database has specific values', () => {
+    beforeAll(() => {
+      createMyFixture('specific-fixture');
+    });
+
     beforeEach(() => {
-      //some hook code
+      seedMyDatabase('specific-fixture');
     });
-    test('inner bar', () => {
-      some_fn();
+
+    afterEach(() => {
+      clearMyFixture('specific-fixture');
+    });
+
+    it('accepts that input', () => {
+      // ...
+    });
+
+    it('throws an error', () => {
+      // ...
+    });
+
+    it('logs a message', () => {
+      // ...
     });
   });
 });