From 7ff01393c958a6eb82dbb449f0657fdaa1d00adf Mon Sep 17 00:00:00 2001
From: Gas One Cent <86567384+gas1cent@users.noreply.github.com>
Date: Thu, 9 Nov 2023 15:00:05 +0400
Subject: [PATCH] docs: review `BondedResponseModule` docs

---
 .../modules/response/bonded_response_module.md      | 13 +++++--------
 1 file changed, 5 insertions(+), 8 deletions(-)

diff --git a/docs/src/content/modules/response/bonded_response_module.md b/docs/src/content/modules/response/bonded_response_module.md
index 5d5b3221..4aaa6c67 100644
--- a/docs/src/content/modules/response/bonded_response_module.md
+++ b/docs/src/content/modules/response/bonded_response_module.md
@@ -10,10 +10,9 @@ The Bonded Response Module is a contract that allows users to propose a response
 
 ### Key Methods
 
-- `decodeRequestData(bytes calldata _data)`: Returns the decoded data for a request.
-- `propose(bytes32 _requestId, address _proposer, bytes calldata _responseData)`: Proposes a response for a request, bonding the proposer's tokens.
-- `deleteResponse(bytes32 _requestId, bytes32 _responseId, address _proposer)`: Allows a user to delete an undisputed response they proposed before the deadline, releasing the bond.
-- `finalizeRequest(bytes32 _requestId, address _finalizer)`: Finalizes the request.
+- `decodeRequestData`: Returns the decoded data for a request.
+- `propose`: Proposes a response for a request, bonding the proposer's tokens.
+- `finalizeRequest`: Finalizes the request.
 
 ### Request Parameters
 
@@ -24,14 +23,12 @@ The Bonded Response Module is a contract that allows users to propose a response
 
 ## 3. Key Mechanisms & Concepts
 
-- Deleting a response: If a proposer realizes the response they've submitted is incorrect, they can delete it. Note that disputed responses cannot be taken back.
-
 - Early finalization: It is possible for pre-dispute modules to atomically calculate the correct response on-chain, decide on the result of a dispute and finalize the request before its deadline.
 
+- Dispute window: Prevents proposers from submitting a response 1 block before the deadline and finalizing it in the next block, leaving disputers no time to dispute the response.
+
 ## 4. Gotchas
 
 - In case of no valid responses, a request can be finalized after the deadline and the requester will get back their tokens.
-- A proposer might submit a response 1 block before the deadline and finalize it in the next block, making it impossible to dispute.
 - Users cannot propose a response after the deadline for a request.
 - Users cannot propose a response if an undisputed response has already been proposed.
-- Users cannot delete a response after the proposing deadline.