docs(ref): more updates (#103)

thephez · web-flow · commit 4c9fe564fa15 · 2025-03-06T11:36:04.000-05:00
* docs(ref): update state transition signing info, part 1

* docs(ref): clarify st signing process

* docs(ref): heading rename

* docs(ref): update st info tables

* docs(ref): add start of identity credit transfer and withdrawal info

* docs(ref): add partial masternode vote st info

* refactor: update table

* docs: refine st signing info

- Divide up info per feedback from Ivan
- Update intro info

* docs(ref): re-order sts

* docs: add missing st to explanation table
diff --git a/docs/explanations/platform-protocol-state-transition.md b/docs/explanations/platform-protocol-state-transition.md
@@ -38,12 +38,13 @@ The following table contains a list of currently defined payload types:
 | - | - |
 | [Data Contract Create](../protocol-ref/data-contract.md#data-contract-creation) (`0`) | [Database schema](../explanations/platform-protocol-data-contract.md) for a single application |
 | [Batch](../protocol-ref/document.md#document-submission) (`1`) | An array of 1 or more [document](../explanations/platform-protocol-document.md) or token transition objects |
-| [Identity Create](../protocol-ref/identity.md#identity-creation) (`2`) | Information including the public keys required to create a new [Identity](../explanations/identity.md) |
+| [Identity Create](../protocol-ref/identity.md#identity-create) (`2`) | Information including the public keys required to create a new [Identity](../explanations/identity.md) |
 | [Identity Topup](../protocol-ref/identity.md#identity-topup) (`3`) | Information including proof of a transaction containing an amount to add to the provided identity's balance |
 | [Data Contract Update](../protocol-ref/data-contract.md#data-contract-update) (`4`) | An updated [database schema](../explanations/platform-protocol-data-contract.md) to modify an existing application |
 | [Identity Update](../protocol-ref/identity.md#identity-update) (`5`) | A set of one or more new public keys to add to the [identity](../explanations/identity.md) or a list of existing keys to disable |
 | [Identity Credit Withdrawal](../protocol-ref/identity.md) (`6`) | Information required to withdraw credits from Dash Platform |
 | [Identity Credit Transfer](../protocol-ref/identity.md) (`7`) | Information required to transfer credits |
+| Masternode Vote (`8`) | Contested resource vote details (e.g., [DPNS premium name vote](../explanations/dpns.md#conflict-resolution)) |
 
 ### Application Usage
 
diff --git a/docs/protocol-ref/identity.md b/docs/protocol-ref/identity.md
@@ -133,9 +133,9 @@ Each identity has a balance of credits established by an [asset lock transaction
 
 ## Identity State Transition Details
 
-There are five identity-related state transitions: [identity create](#identity-creation), [identity topup](#identity-topup), [identity update](#identity-update), [identity credit transfer](#identity-credit-transfer), and [identity credit withdrawal](#identity-credit-withdrawal). Details are provided in this section including information about [asset locking](#asset-lock) and [signing](#identity-state-transition-signing) required for these state transitions.
+There are five identity-related state transitions: [identity create](#identity-create), [identity topup](#identity-topup), [identity update](#identity-update), [identity credit transfer](#identity-credit-transfer), and [identity credit withdrawal](#identity-credit-withdrawal). Details are provided in this section including information about [asset locking](#asset-lock) and [signing](#identity-state-transition-signing) required for these state transitions.
 
-### Identity Creation
+### Identity Create
 
 Identities are created on the platform by submitting the identity information in an identity create state transition.
 
@@ -225,7 +225,7 @@ See the [identity credit withdrawal implementation in rs-dpp](https://github.com
 
 ### Asset Lock
 
-The [identity create](#identity-creation) and [identity topup](#identity-topup) state transitions both include an asset lock proof object. This object references the Core chain [asset lock transaction](inv:user:std#ref-txs-assetlocktx) and includes proof that the transaction is locked.
+The [identity create](#identity-create) and [identity topup](#identity-topup) state transitions both include an asset lock proof object. This object references the Core chain [asset lock transaction](inv:user:std#ref-txs-assetlocktx) and includes proof that the transaction is locked.
 
 Currently there are two types of asset lock proofs [defined by rs-dpp](https://github.com/dashpay/platform/blob/v2.0-dev/packages/rs-dpp/src/identity/state_transition/asset_lock_proof/mod.rs#L129-L132): InstantSend and ChainLock. Transactions almost always receive InstantSend locks, so the InstantSend asset lock proof is the predominate type. See rs-dpp for examples of using [InstantSend](https://github.com/dashpay/platform/blob/v2.0-dev/packages/rs-dpp/src/identity/state_transition/asset_lock_proof/instant/instant_asset_lock_proof.rs) or [ChainLocks](https://github.com/dashpay/platform/blob/v2.0-dev/packages/rs-dpp/src/identity/state_transition/asset_lock_proof/chain/chain_asset_lock_proof.rs) as the asset lock proof.
 
diff --git a/docs/protocol-ref/overview.md b/docs/protocol-ref/overview.md
@@ -19,35 +19,3 @@ The current reference implementation is the (Rust) [rs-dpp](https://github.com/d
 ## Release Notes
 
 Release notes for past versions are located on the [dashpay/platform GitHub release page](https://github.com/dashpay/platform/releases). They provide information about breaking changes, features, and fixes.
-
-## Topics
-
-[Identities](../protocol-ref/identity.md)
-
-- [Create](../protocol-ref/identity.md#identity-creation)
-- [TopUp](../protocol-ref/identity.md#identity-topup)
-
-[Data Contracts](../protocol-ref/data-contract.md)
-
-- [Documents](../protocol-ref/data-contract.md#data-contract-documents)
-  - [Properties](../protocol-ref/data-contract.md#document-properties)
-  - [Indices](../protocol-ref/data-contract.md#document-indices)
-- [Definitions](../protocol-ref/data-contract.md#data-contract-definitions)
-
-[Document](../protocol-ref/document.md)
-
-[State Transitions](../protocol-ref/state-transition.md)
-
-- [Overview / general structure](../protocol-ref/state-transition.md)
-- Types
-  - [Identity Create ST](../protocol-ref/identity.md#identity-creation)
-  - [Data Contract ST](../protocol-ref/data-contract.md#data-contract-creation)
-  - [Batch ST](../protocol-ref/document.md)
-    - Document Transitions
-      - [Document Transition Base](../protocol-ref/document.md#document-base-transition)
-      - [Document Create Transition](../protocol-ref/document.md#document-create-transition)
-      - [Document Replace Transition](../protocol-ref/document.md#document-replace-transition)
-      - [Document Delete Transition](../protocol-ref/document.md#document-delete-transition)
-- [Signing](../protocol-ref/state-transition.md#state-transition-signing)
-
-[Data Triggers](../protocol-ref/data-trigger.md)
diff --git a/docs/protocol-ref/state-transition.md b/docs/protocol-ref/state-transition.md
