counter-script docs

counter-script/project/contracts/counter/src/main.sw

@@ -3,6 +3,7 @@ contract;
 use libraries::Counter;
 
 storage {
+    /// Internal counter updated via calls from a script.
     count: u64 = 0,
 }
 

counter-script/project/libraries/src/interface.sw

@@ -1,10 +1,34 @@
 library;
 
 abi Counter {
+    /// Increments the counter by one.
+    ///
+    /// # Returns
+    ///
+    /// * [u64] - The new value of the counter.
+    ///
+    /// # Number of Storage Accesses
+    ///
+    /// * Reads: `1`
+    /// * Write: `1`
     #[storage(read, write)]
     fn increment() -> u64;
+    /// Returns the current value of the counter.
+    ///
+    /// # Returns
+    ///
+    /// * [u64] - The current value of the counter.
+    ///
+    /// # Number of Storage Accesses
+    ///
+    /// * Reads: `1`
     #[storage(read)]
     fn count() -> u64;
+    /// Clears the counter.
+    ///
+    /// # Number of Storage Accesses
+    ///
+    /// * Clears: `1`
     #[storage(write)]
     fn clear();
 }

counter-script/project/scripts/interaction_script/src/main.sw

@@ -2,6 +2,16 @@ script;
 
 use libraries::Counter;
 
+/// Calls the methods of the counter contract at the given contract_id.
+///
+/// # Arguments
+///
+/// * `contract_id`: [ContractId] - The ContractId at which the counter contract is deployed.
+/// * `clear`: [bool] - If true, the counter will be cleared at the end of the script.
+///
+/// # Returns
+///
+/// * [u64] - The count at the end of the script.
 fn main(contract_id: ContractId, clear: bool) -> u64 {
     // An abi cast is a way to call a contract at a given contract_id with the given abi
     let counter = abi(Counter, contract_id.value);