Add mediator section to trading rules

index.adoc

@@ -38,7 +38,7 @@ image::quick-link-4.png[alt=Make a Compensation Request,width=200,role=quick-lin
  * <<secure-wallet#, Secure Your Wallet>> — _Set a password and save your seed words to keep your bitcoin safe_
  * <<backup-recovery#, Backup and Recovery>> — _Maintain backups to keep your settings and history safe_
  * Staying Private — _Maximize control over your personal info and trading data_
- * <<trading-rules#, Trading and Arbitration Rules>> — _Know what's expected of you and others when trading_
+ * <<trading-rules#, Trading Rules and Dispute Resolution>> — _Know what's expected of you and others when trading_
  * Fees and Security Deposits — _Understand how your bitcoin is used and kept safe when trading_
  * Support — _Get help from other Bisq users and contributors_
  * Payment Methods — _Explore https://bisq.network/faq/#supported-payment-methods[20+] supported fiat currency payment methods, from Alipay to Zelle_

trading-rules.adoc

@@ -1,4 +1,4 @@
-= Trading and Arbitration Rules
+= Trading Rules and Dispute Resolution
 :imagesdir: images
 :!figure-caption:
 
@@ -28,7 +28,7 @@ NOTE: The rules listed below are default rules for every transaction. Offer make
 
 == Arbitration
 
-When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution.
+When trading partners cannot successfully complete a trade on their own, the trade is disputed, and an arbitrator steps in to determine a solution. Arbitrators have the third key in the 2-of-3 multisig escrow transaction, so their decision is authoritative.
 
 The following are possible circumstances and resulting outcomes.
 
@@ -59,6 +59,16 @@ The BTC seller gets all the escrow funds.
 
 The BTC buyer gets the trade amount but loses their security deposit.
 
+== Mediation
+
+Mediators are like arbitrators, in that their job is to evaluate a trade situation between two users. But unlike arbitrators, they do not have a key in the multisig escrow transaction, so their decision on how to resolve a dispute is _not authoritative_—it's merely a _suggestion_.
+
+If both traders agree with the mediator's suggested payout, the payout is completed and the trade is closed. If one or both traders disagree with the suggestion, the situation is then re-evaluated by an arbitrator who makes the payout based on their findings.
+
+Mediation is the cornerstone of Bisq's new trade protocol, which seeks to eventually eliminate the need for arbitrators. This new protocol will be implemented in stages, with trader chat and mediation implemented first in parallel with the existing trade protocol with arbitrators, before an eventual switchover to a protocol without arbitrators.
+
+You can learn more about the new trade protocol in https://github.com/bisq-network/proposals/issues/52[this issue^] or in https://www.youtube.com/watch?v=cZtg2sjXli0[this video^]. Please note that the new trade protocol is a work in progress, so details in those links may have since changed.
+
 == Face-to-Face (F2F) Trading
 [[f2f-trading]]