docs: v23 gui updates

docs/user/governance/using.rst

@@ -58,7 +58,7 @@ Object structure
 
 The following information is required to create a proposal:
 
-- proposal-name: a unique label, 20 characters or less
+- proposal-name: a unique label, 40 characters or less
 - url: a proposer-created webpage or forum post containing detailed
   proposal information
 - payment-count: how many cycles the proposal is requesting payment
@@ -140,11 +140,143 @@ You can view the source code for this calculation at this
 Creating proposals
 ==================
 
-Once you have prepared the text of your proposal and set up a website or
-forum post, it is time to submit your proposal to the blockchain for
-voting. While all tasks involved with creating a budget proposal can be
-executed from the Dash Core wallet console, several tools providing a
-user interface have been developed to simplify this procedure.
+Once you have prepared the text of your proposal and set up a website or forum post, it is time to
+submit your proposal to the blockchain for voting. While all tasks involved with creating a budget
+proposal can be executed from the Dash Core wallet (:ref:`GUI <proposal-create-core-qt>` or
+:ref:`console <proposal-create-core-console>`) or the :ref:`Dash Budget Proposal Generator
+<dash-budget-proposal-generator>`.
+
+.. _proposal-create-core-qt:
+
+Dash Core Wallet
+----------------
+
+Dash Core Wallet includes a built-in graphical interface for creating governance proposals directly
+from the Governance tab. This provides a user-friendly alternative to using external web tools or
+manual console commands. To use this feature, your wallet must be unlocked and contain sufficient
+balance to cover the 1 DASH proposal fee plus a small transaction fee.
+
+Accessing the Governance tab
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+Open your Dash Core Wallet and click on the **Governance** tab. This displays a list of existing
+proposals and provides a **Create Proposal** button in the upper right corner.
+
+.. figure:: img/core-qt/governance-tab.png
+   :width: 500px
+
+   The Governance tab showing existing proposals and the Create Proposal button
+
+Creating a new proposal
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Click the **Create Proposal** button to open the proposal creation dialog. Enter your proposal
+details:
+
+- **Proposal name**: A unique identifier
+- **URL**: Link to detailed proposal information (use a URL shortener if needed)
+- **Payment address**: The Dash address that will receive payments
+- **Payment amount**: Amount requested per payment cycle
+- **First payment date**: Select the superblock date for the first payment
+- **# of payments**: Number of payment cycles requested
+
+The dialog displays the total amount requested and notes the 1 DASH proposal fee that will be
+burned. Click **Next** when all fields are complete.
+
+.. figure:: img/core-qt/proposal-create.png
+   :width: 350px
+
+   Entering proposal details in the creation dialog
+
+Validating the proposal
+^^^^^^^^^^^^^^^^^^^^^^^
+
+The wallet will generate and display your proposal data in JSON format along with the proposal hash.
+Review the information carefully to ensure accuracy.
+
+Click **Validate** to check the format of the proposal data. If the data is valid, click **Next** to
+proceed to the next step. Otherwise, click **Back** to adjust your proposal data.
+
+.. figure:: img/core-qt/proposal-validate.png
+   :width: 400px
+
+   Validating the proposal JSON and hash
+
+Preparing the collateral
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+.. warning::
+
+   The following step will create a transaction burning 1 DASH as the proposal submission fee. This
+   transaction is irreversible once broadcast. Verify all proposal details are correct before
+   proceeding.
+
+After validation, you will see a screen prompting you to prepare and burn the 1 DASH collateral fee.
+This fee is required to prevent spam and is permanently removed from circulation. Click **Prepare
+proposal** to create the fee transaction.
+
+.. figure:: img/core-qt/proposal-prepare-burn.png
+   :width: 350px
+
+   Proposal collateral burn preparation screen
+
+Click **Yes** on the confirmation dialog to broadcast the collateral transaction.
+
+.. figure:: img/core-qt/proposal-burn-fee-notice.png
+   :width: 300px
+
+   Confirmation dialog for burning the proposal fee
+
+The transaction ID will be generated and displayed in the TxID field.
+
+.. figure:: img/core-qt/proposal-prepare-burned.png
+   :width: 350px
+
+   Transaction ID generated for the proposal collateral
+
+Waiting for confirmations
+^^^^^^^^^^^^^^^^^^^^^^^^^
+
+The wallet will display the confirmation progress for your collateral transaction. One confirmation
+is required before you can submit the proposal to the network. After the first confirmation, click
+the **Next** button to move to the proposal submission screen.
+
+.. figure:: img/core-qt/proposal-prepare-burned-conf-wait.png
+   :width: 350px
+
+   Waiting for confirmations (1 of 6)
+
+Submitting the proposal
+^^^^^^^^^^^^^^^^^^^^^^^
+
+Click **Submit Proposal** to broadcast your governance object to the network.
+
+.. figure:: img/core-qt/proposal-submit-awaiting.png
+   :width: 350px
+
+   Submitting proposal with 5 of 6 confirmations
+
+If successful, a message will be displayed with your proposal ID. Click **OK** to close the message.
+
+.. figure:: img/core-qt/proposal-submitted-conf.png
+   :width: 300px
+
+   Proposal successfully submitted to the network
+
+The proposal ID will also be shown on the submission screen. The proposal ID can be used to track
+voting on the proposal.
+
+.. figure:: img/core-qt/proposal-submitted.png
+   :width: 350px
+
+   Proposal submitted with proposal ID shown
+
+.. note::
+
+   You can submit your proposal ID to DashCentral to claim ownership and enable simplified voting
+   for masternodes using DashCentral voting services.
+
+.. _dash-budget-proposal-generator:
 
 Dash Budget Proposal Generator
 ------------------------------
@@ -217,16 +349,7 @@ closes and you receive your payout. You can also submit the ID to
 DashCentral to claim your proposal and enable simplified voting for
 masternodes using DashCentral voting services.
 
-DashCentral Proposal Generator
-------------------------------
-
-- https://www.dashcentral.org/budget/create
-
-DashCentral also includes a tool to create budget proposals, or claim
-existing proposals so you can add a description on DashCentral and begin
-discussion with the community. The steps to be taken are almost
-identical to the procedure described above, and documentation is
-available `here <https://www.dashcentral.org/about/contact>`_.
+.. _proposal-create-core-console:
 
 Dash Core Wallet Console
 ------------------------

docs/user/wallets/dashcore/installation-linux.rst

@@ -211,20 +211,69 @@ wallet in the following section.
 .. figure:: img/linux/dash-name-wallet.png
    :width: 300px
 
+Setting your password
+^^^^^^^^^^^^^^^^^^^^^
+
 If you do choose to encrypt now, you will be asked to enter and verify a password.
 
 .. figure:: img/linux/dash-encrypt-wallet.png
    :height: 175px
 
    Enter a password
 
-Following that, you will get a standard warning.
+Following that, you will get a standard warning. Click **Yes** to continue.
 
 .. figure:: img/linux/dash-encrypt-wallet-confirmation.png
    :width: 350px
 
    Confirm you want to encrypt your wallet
 
+.. _dashcore-wallet-mnemonic-backup:
+
+Backing up your mnemonic
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets
+(encrypted or not). This phrase can be used to restore your wallet if you lose access to your
+device.
+
+.. warning::
+
+   **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your
+   wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure
+   location. Never share your mnemonic with anyone.
+
+.. figure:: img/linux/dash-mnemonic-save.png
+   :width: 400px
+
+   Mnemonic phrase backup prompt
+
+Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order
+and check the "I have written down my mnemonic" checkbox to continue.
+
+.. figure:: img/linux/dash-mnemonic-save-show.png
+   :width: 400px
+
+   Revealing the mnemonic phrase
+
+Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words
+from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic
+phrase. 
+
+As you enter each word correctly, a green checkmark will appear beside it. Once you have
+successfully verified your mnemonic, click **Continue** to complete the wallet creation process.
+
+
+.. figure:: img/linux/dash-mnemonic-save-confirm.png
+   :width: 400px
+
+   Mnemonic verification
+
+.. note::
+
+   For more information about HD wallets and how to view or restore your mnemonic phrase later, see
+   the :hoverxref:`advanced topics section <dashcore-hd>`.
+
 The following section will detail the steps you need to follow if you 
 choose to encrypt your Dash wallet later.
 

docs/user/wallets/dashcore/installation-macos.rst

@@ -172,6 +172,9 @@ wallet in the following section.
 .. figure:: img/macos/wallet-name.png
    :width: 300px
 
+Setting your password
+^^^^^^^^^^^^^^^^^^^^^
+
 If you do choose to encrypt now, you will be asked to enter and verify a password.
 
 .. figure:: img/macos/112596740.png
@@ -186,6 +189,50 @@ Following that, you will get a standard warning.
 
    Confirm you want to encrypt your wallet
 
+Backing up your mnemonic
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets
+(encrypted or not). This phrase can be used to restore your wallet if you lose access to your
+device.
+
+.. warning::
+
+   **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your
+   wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure
+   location. Never share your mnemonic with anyone.
+
+.. figure:: img/macos/dash-mnemonic-save.png
+   :width: 400px
+
+   Mnemonic phrase backup prompt
+
+Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order
+and check the "I have written down my mnemonic" checkbox to continue.
+
+.. figure:: img/macos/dash-mnemonic-save-show.png
+   :width: 400px
+
+   Revealing the mnemonic phrase
+
+Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words
+from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic
+phrase. 
+
+As you enter each word correctly, a green checkmark will appear beside it. Once you have
+successfully verified your mnemonic, click **Continue** to complete the wallet creation process.
+
+
+.. figure:: img/macos/dash-mnemonic-save-confirm.png
+   :width: 400px
+
+   Mnemonic verification
+
+.. note::
+
+   For more information about HD wallets and how to view or restore your mnemonic phrase later, see
+   the :hoverxref:`advanced topics section <dashcore-hd>`.
+
 The following section will detail the steps you need to follow if you
 choose to encrypt your Dash wallet later.
 

docs/user/wallets/dashcore/installation-windows.rst

@@ -220,6 +220,9 @@ wallet in the following section.
 .. figure:: img/windows/dash-name-wallet.png
    :width: 300px
 
+Setting your password
+^^^^^^^^^^^^^^^^^^^^^
+
 If you do choose to encrypt now, you will be asked to enter and verify a password.
 
 .. figure:: img/windows/dash-encrypt-wallet.png
@@ -234,6 +237,50 @@ Following that, you will get a standard warning.
 
    Confirm you want to encrypt your wallet
 
+Backing up your mnemonic
+^^^^^^^^^^^^^^^^^^^^^^^^
+
+Dash Core will display your mnemonic phrase (also called a recovery phrase) for all wallets
+(encrypted or not). This phrase can be used to restore your wallet if you lose access to your
+device.
+
+.. warning::
+
+   **CRITICAL**: If you lose your mnemonic seed phrase, you will permanently lose access to your
+   wallet and all funds. Write it down on paper (not digitally) and store it in a safe, secure
+   location. Never share your mnemonic with anyone.
+
+.. figure:: img/linux/dash-mnemonic-save.png
+   :width: 400px
+
+   Mnemonic phrase backup prompt
+
+Click the **Show** button to reveal your mnemonic phrase. Then, write down all the words in order
+and check the "I have written down my mnemonic" checkbox to continue.
+
+.. figure:: img/linux/dash-mnemonic-save-show.png
+   :width: 400px
+
+   Revealing the mnemonic phrase
+
+Dash Core will then ask you to verify that you correctly saved the phrase by entering specific words
+from your mnemonic. Enter the requested words to confirm you have properly saved your mnemonic
+phrase. 
+
+As you enter each word correctly, a green checkmark will appear beside it. Once you have
+successfully verified your mnemonic, click **Continue** to complete the wallet creation process.
+
+
+.. figure:: img/linux/dash-mnemonic-save-confirm.png
+   :width: 400px
+
+   Mnemonic verification
+
+.. note::
+
+   For more information about HD wallets and how to view or restore your mnemonic phrase later, see
+   the :hoverxref:`advanced topics section <dashcore-hd>`.
+
 The following section will detail the steps you need to follow if you 
 choose to encrypt your Dash wallet later.