🥋 Update docs with chaining emit matchers (#693)

.changeset/tricky-spiders-invite.md

@@ -0,0 +1,5 @@
+---
+"@ethereum-waffle/chai": patch
+---
+
+Allow to chain emit matchers

docs/source/matchers.rst

@@ -57,6 +57,16 @@ Testing with indexed bytes or string parameters. These two examples are equivale
     .to.emit(contract, 'AddAddress')
     .withArgs(hashedStreet, hashedCity);
 
+If you are using Waffle version :code:`3.4.4` or lower, you can't chain :code:`emit` matchers like in example below.
+
+.. code-block:: ts
+
+  await expect(tx)
+    .to.emit(contract, 'One')
+    .to.emit(contract, 'Two');
+
+This feature will be available in Waffle version 4.
+
 Called on contract
 ------------------
 

docs/source/migration-guides.rst

@@ -435,3 +435,22 @@ In the new Ganache, you should not override the wallet config, otherwise you mig
       }
     }
   })
+
+Chaining :code:`emit` matchers
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Now when testing events on a smart contract you can conveniently chain :code:`emit` matchers.
+
+.. code-block:: ts
+  
+  const tx = await contract.emitEventsOneAndTwo();
+  await expect(tx)
+        .to.emit(contract, 'One').withArgs(
+          1,
+          'One'
+        )
+        .to.emit(contract, 'Two').withArgs(
+          2,
+          'Two'
+        )
+        .to.not.emit(contract, 'Three');