docs: minor things

Author: jaybuidl

contracts/src/arbitration/KlerosCoreBase.sol

@@ -12,8 +12,8 @@ import {SafeERC20, IERC20} from "../libraries/SafeERC20.sol";
 import "../libraries/Constants.sol";
 
 /// @title KlerosCoreBase
-/// Core arbitrator contract for Kleros v2 with new StakeController architecture.
-/// Note that this contract trusts the PNK token, the dispute kit and the stake controller contracts.
+/// Core arbitrator contract for Kleros v2.
+/// Note that this contract trusts the dispute kit and the stake controller contracts.
 abstract contract KlerosCoreBase is IArbitratorV2, Initializable, UUPSProxiable {
     using SafeERC20 for IERC20;
 

contracts/src/arbitration/SortitionSumTree.sol

@@ -121,6 +121,7 @@ contract SortitionSumTree is ISortitionSumTree, Initializable, UUPSProxiable {
         KlerosCoreBase core = stakeController.core();
 
         while (!finished) {
+            // Tokens are also implicitly staked in parent courts via _updateParents().
             _set(bytes32(uint256(currentCourtID)), _newStake, stakePathID);
             if (currentCourtID == GENERAL_COURT) {
                 finished = true;

contracts/src/arbitration/Vault.sol

@@ -6,9 +6,8 @@ import {VaultBase, IERC20} from "./VaultBase.sol";
 
 /// @title Vault
 /// @notice PNK Vault for handling deposits, withdrawals, locks, and penalties
-/// @dev Follows the same pattern as KlerosCore for upgradeable contracts
 contract Vault is VaultBase {
-    string public constant override version = "0.1.0";
+    string public constant override version = "0.10.0";
 
     // ************************************* //
     // *            Constructor            * //

contracts/src/arbitration/VaultBase.sol

@@ -9,7 +9,6 @@ import {SafeERC20, IERC20} from "../libraries/SafeERC20.sol";
 
 /// @title VaultBase
 /// @notice Abstract base contract for PNK vault that handles deposits, withdrawals, locks, and penalties
-/// @dev Follows the same pattern as KlerosCoreBase for upgradeable contracts
 abstract contract VaultBase is IVault, Initializable, UUPSProxiable {
     using SafeERC20 for IERC20;
 
@@ -31,15 +30,8 @@ abstract contract VaultBase is IVault, Initializable, UUPSProxiable {
     IERC20 public pnk; // The PNK token contract.
     address public stakeController; // The stake controller authorized to lock/unlock/penalize.
     address public core; // The KlerosCore authorized to transfer rewards.
-
     mapping(address => JurorBalance) public jurorBalances; // Juror balance tracking.
 
-    // ************************************* //
-    // *              Events               * //
-    // ************************************* //
-
-    // Events are defined in IVault interface
-
     // ************************************* //
     // *        Function Modifiers         * //
     // ************************************* //

contracts/src/arbitration/VaultNeo.sol

@@ -8,7 +8,6 @@ import "@openzeppelin/contracts/token/ERC721/IERC721.sol";
 
 /// @title VaultNeo
 /// @notice Enhanced PNK Vault with additional features like NFT-gated deposits
-/// @dev Follows the same pattern as KlerosCoreNeo for upgradeable contracts
 contract VaultNeo is VaultBase {
     using SafeERC20 for IERC20;