From bd14474cd3be5300d26f8e1abf8da8bd0e264476 Mon Sep 17 00:00:00 2001 From: 0o-de-lally <1364012+0o-de-lally@users.noreply.github.com> Date: Tue, 20 Aug 2024 17:14:03 -0400 Subject: [PATCH] publish reviewed docs --- ...-desktop-app.md => carpe-desktop-app.todo} | 0 ...-resources.md => developer-resources.todo} | 0 .../technology}/historical-tech-stack.todo | 0 docs/cli-tools/{config.todo => config.md} | 0 .../{first-steps.todo => first-steps.depr} | 0 ...ting-started.todo => getting-started.depr} | 0 docs/cli-tools/move/{index.todo => index.md} | 2 +- docs/cli-tools/node/{index.todo => index.md} | 0 .../query/{balance.todo => balance.md} | 0 docs/cli-tools/query/{epoch.todo => epoch.md} | 1 + ...etting-started.todo => getting-started.md} | 0 .../query/{resources.todo => resources.md} | 0 .../query/{val-config.todo => val-config.md} | 0 docs/cli-tools/query/{view.todo => view.md} | 0 docs/cli-tools/testnet/_category_.json | 7 + .../testnet/genesis-instructions.md} | 0 .../testnet/validator-registration.md} | 0 .../txs}/communtiy-wallet-activation.md | 0 ...ansaction.todo => generate-transaction.md} | 0 .../txs/key-rotation.md} | 0 .../txs/{transfer.todo => transfer.md} | 0 .../txs/{upgrade.todo => upgrade.md} | 0 .../txs/{validator.todo => validator.md} | 0 docs/cli-tools/{wallet.todo => wallet.md} | 0 ...ev-quick-start.todo => dev-quick-start.md} | 0 ...rification.todo => formal-verification.md} | 0 docs/{cli-tools => core-devs}/genesis.todo | 0 ...e-fixtures.todo => governance-fixtures.md} | 0 ...ntions.todo => move-coding-conventions.md} | 0 .../{smoke-tests.todo => smoke-tests.md} | 0 ...{testnet-deploy.todo => testnet-deploy.md} | 0 .../testnet-depoloy-publish.todo} | 0 docs/{misc => core-devs}/tool-design.todo | 0 docs/misc/_category_.json | 8 - docs/misc/hot-upgrades.todo | 161 ------------------ ...ructions.todo => detailed-instructions.md} | 0 ...etting-started.todo => getting-started.md} | 0 .../{hot-upgrades.todo => hot-upgrades.md} | 0 docs/validators/{rescue.todo => rescue.md} | 0 .../sybil-resistance.md} | 0 ...uickstart.todo => validator-quickstart.md} | 0 .../{vfn-setup.todo => vfn-setup.md} | 0 ...docker-setup.todo => with-docker-setup.md} | 0 .../{fullnode-yaml.todo => fullnode-yaml.md} | 0 ...{validator-yaml.todo => validator-yaml.md} | 0 .../{vfn-yaml.todo => vfn-yaml.md} | 0 46 files changed, 9 insertions(+), 170 deletions(-) rename docs/archive/technology/{carpe-desktop-app.md => carpe-desktop-app.todo} (100%) rename docs/archive/technology/{developer-resources.md => developer-resources.todo} (100%) rename docs/{about => archive/technology}/historical-tech-stack.todo (100%) rename docs/cli-tools/{config.todo => config.md} (100%) rename docs/cli-tools/{first-steps.todo => first-steps.depr} (100%) rename docs/cli-tools/{getting-started.todo => getting-started.depr} (100%) rename docs/cli-tools/move/{index.todo => index.md} (99%) rename docs/cli-tools/node/{index.todo => index.md} (100%) rename docs/cli-tools/query/{balance.todo => balance.md} (100%) rename docs/cli-tools/query/{epoch.todo => epoch.md} (99%) rename docs/cli-tools/query/{getting-started.todo => getting-started.md} (100%) rename docs/cli-tools/query/{resources.todo => resources.md} (100%) rename docs/cli-tools/query/{val-config.todo => val-config.md} (100%) rename docs/cli-tools/query/{view.todo => view.md} (100%) create mode 100644 docs/cli-tools/testnet/_category_.json rename docs/{misc/genesis-instructions.todo => cli-tools/testnet/genesis-instructions.md} (100%) rename docs/{misc/validator-registration.todo => cli-tools/testnet/validator-registration.md} (100%) rename docs/{misc => cli-tools/txs}/communtiy-wallet-activation.md (100%) rename docs/cli-tools/txs/{generate-transaction.todo => generate-transaction.md} (100%) rename docs/{misc/key-rotation.todo => cli-tools/txs/key-rotation.md} (100%) rename docs/cli-tools/txs/{transfer.todo => transfer.md} (100%) rename docs/cli-tools/txs/{upgrade.todo => upgrade.md} (100%) rename docs/cli-tools/txs/{validator.todo => validator.md} (100%) rename docs/cli-tools/{wallet.todo => wallet.md} (100%) rename docs/core-devs/{dev-quick-start.todo => dev-quick-start.md} (100%) rename docs/core-devs/{formal-verification.todo => formal-verification.md} (100%) rename docs/{cli-tools => core-devs}/genesis.todo (100%) rename docs/core-devs/{governance-fixtures.todo => governance-fixtures.md} (100%) rename docs/core-devs/{move-coding-conventions.todo => move-coding-conventions.md} (100%) rename docs/core-devs/{smoke-tests.todo => smoke-tests.md} (100%) rename docs/core-devs/{testnet-deploy.todo => testnet-deploy.md} (100%) rename docs/{cli-tools/txs/publish.todo => core-devs/testnet-depoloy-publish.todo} (100%) rename docs/{misc => core-devs}/tool-design.todo (100%) delete mode 100644 docs/misc/_category_.json delete mode 100644 docs/misc/hot-upgrades.todo rename docs/validators/{detailed-instructions.todo => detailed-instructions.md} (100%) rename docs/validators/{getting-started.todo => getting-started.md} (100%) rename docs/validators/{hot-upgrades.todo => hot-upgrades.md} (100%) rename docs/validators/{rescue.todo => rescue.md} (100%) rename docs/{misc/sybil-resistance.todo => validators/sybil-resistance.md} (100%) rename docs/validators/{validator-quickstart.todo => validator-quickstart.md} (100%) rename docs/validators/{vfn-setup.todo => vfn-setup.md} (100%) rename docs/validators/{with-docker-setup.todo => with-docker-setup.md} (100%) rename docs/validators/yaml-templates/{fullnode-yaml.todo => fullnode-yaml.md} (100%) rename docs/validators/yaml-templates/{validator-yaml.todo => validator-yaml.md} (100%) rename docs/validators/yaml-templates/{vfn-yaml.todo => vfn-yaml.md} (100%) diff --git a/docs/archive/technology/carpe-desktop-app.md b/docs/archive/technology/carpe-desktop-app.todo similarity index 100% rename from docs/archive/technology/carpe-desktop-app.md rename to docs/archive/technology/carpe-desktop-app.todo diff --git a/docs/archive/technology/developer-resources.md b/docs/archive/technology/developer-resources.todo similarity index 100% rename from docs/archive/technology/developer-resources.md rename to docs/archive/technology/developer-resources.todo diff --git a/docs/about/historical-tech-stack.todo b/docs/archive/technology/historical-tech-stack.todo similarity index 100% rename from docs/about/historical-tech-stack.todo rename to docs/archive/technology/historical-tech-stack.todo diff --git a/docs/cli-tools/config.todo b/docs/cli-tools/config.md similarity index 100% rename from docs/cli-tools/config.todo rename to docs/cli-tools/config.md diff --git a/docs/cli-tools/first-steps.todo b/docs/cli-tools/first-steps.depr similarity index 100% rename from docs/cli-tools/first-steps.todo rename to docs/cli-tools/first-steps.depr diff --git a/docs/cli-tools/getting-started.todo b/docs/cli-tools/getting-started.depr similarity index 100% rename from docs/cli-tools/getting-started.todo rename to docs/cli-tools/getting-started.depr diff --git a/docs/cli-tools/move/index.todo b/docs/cli-tools/move/index.md similarity index 99% rename from docs/cli-tools/move/index.todo rename to docs/cli-tools/move/index.md index 8e19c41c..3d019feb 100644 --- a/docs/cli-tools/move/index.todo +++ b/docs/cli-tools/move/index.md @@ -217,7 +217,7 @@ $ libra txs generate-transaction --function-id 0xd1281de242839fc939745996882c5fc ### View functions :::note -The `libra move view` feature is currently not available but we have a couple of workarounds for viewing move functions and values. View a full description [here](../getting-started.md) +The `libra move view` feature is currently not available but we have a couple of workarounds for viewing move functions and values. ::: ```bash $ libra query move-value --account 0xd1281de242839fc939745996882c5fc2 --module-name message --struct-name MessageHolder --key-name message diff --git a/docs/cli-tools/node/index.todo b/docs/cli-tools/node/index.md similarity index 100% rename from docs/cli-tools/node/index.todo rename to docs/cli-tools/node/index.md diff --git a/docs/cli-tools/query/balance.todo b/docs/cli-tools/query/balance.md similarity index 100% rename from docs/cli-tools/query/balance.todo rename to docs/cli-tools/query/balance.md diff --git a/docs/cli-tools/query/epoch.todo b/docs/cli-tools/query/epoch.md similarity index 99% rename from docs/cli-tools/query/epoch.todo rename to docs/cli-tools/query/epoch.md index ce91c213..957186f0 100644 --- a/docs/cli-tools/query/epoch.todo +++ b/docs/cli-tools/query/epoch.md @@ -1,3 +1,4 @@ + --- sidebar_label: 'Epoch' sidebar_position: 5 diff --git a/docs/cli-tools/query/getting-started.todo b/docs/cli-tools/query/getting-started.md similarity index 100% rename from docs/cli-tools/query/getting-started.todo rename to docs/cli-tools/query/getting-started.md diff --git a/docs/cli-tools/query/resources.todo b/docs/cli-tools/query/resources.md similarity index 100% rename from docs/cli-tools/query/resources.todo rename to docs/cli-tools/query/resources.md diff --git a/docs/cli-tools/query/val-config.todo b/docs/cli-tools/query/val-config.md similarity index 100% rename from docs/cli-tools/query/val-config.todo rename to docs/cli-tools/query/val-config.md diff --git a/docs/cli-tools/query/view.todo b/docs/cli-tools/query/view.md similarity index 100% rename from docs/cli-tools/query/view.todo rename to docs/cli-tools/query/view.md diff --git a/docs/cli-tools/testnet/_category_.json b/docs/cli-tools/testnet/_category_.json new file mode 100644 index 00000000..c7495288 --- /dev/null +++ b/docs/cli-tools/testnet/_category_.json @@ -0,0 +1,7 @@ +{ + "label": "Testnet", + "position": 2, + "link": { + "type": "generated-index" + } +} diff --git a/docs/misc/genesis-instructions.todo b/docs/cli-tools/testnet/genesis-instructions.md similarity index 100% rename from docs/misc/genesis-instructions.todo rename to docs/cli-tools/testnet/genesis-instructions.md diff --git a/docs/misc/validator-registration.todo b/docs/cli-tools/testnet/validator-registration.md similarity index 100% rename from docs/misc/validator-registration.todo rename to docs/cli-tools/testnet/validator-registration.md diff --git a/docs/misc/communtiy-wallet-activation.md b/docs/cli-tools/txs/communtiy-wallet-activation.md similarity index 100% rename from docs/misc/communtiy-wallet-activation.md rename to docs/cli-tools/txs/communtiy-wallet-activation.md diff --git a/docs/cli-tools/txs/generate-transaction.todo b/docs/cli-tools/txs/generate-transaction.md similarity index 100% rename from docs/cli-tools/txs/generate-transaction.todo rename to docs/cli-tools/txs/generate-transaction.md diff --git a/docs/misc/key-rotation.todo b/docs/cli-tools/txs/key-rotation.md similarity index 100% rename from docs/misc/key-rotation.todo rename to docs/cli-tools/txs/key-rotation.md diff --git a/docs/cli-tools/txs/transfer.todo b/docs/cli-tools/txs/transfer.md similarity index 100% rename from docs/cli-tools/txs/transfer.todo rename to docs/cli-tools/txs/transfer.md diff --git a/docs/cli-tools/txs/upgrade.todo b/docs/cli-tools/txs/upgrade.md similarity index 100% rename from docs/cli-tools/txs/upgrade.todo rename to docs/cli-tools/txs/upgrade.md diff --git a/docs/cli-tools/txs/validator.todo b/docs/cli-tools/txs/validator.md similarity index 100% rename from docs/cli-tools/txs/validator.todo rename to docs/cli-tools/txs/validator.md diff --git a/docs/cli-tools/wallet.todo b/docs/cli-tools/wallet.md similarity index 100% rename from docs/cli-tools/wallet.todo rename to docs/cli-tools/wallet.md diff --git a/docs/core-devs/dev-quick-start.todo b/docs/core-devs/dev-quick-start.md similarity index 100% rename from docs/core-devs/dev-quick-start.todo rename to docs/core-devs/dev-quick-start.md diff --git a/docs/core-devs/formal-verification.todo b/docs/core-devs/formal-verification.md similarity index 100% rename from docs/core-devs/formal-verification.todo rename to docs/core-devs/formal-verification.md diff --git a/docs/cli-tools/genesis.todo b/docs/core-devs/genesis.todo similarity index 100% rename from docs/cli-tools/genesis.todo rename to docs/core-devs/genesis.todo diff --git a/docs/core-devs/governance-fixtures.todo b/docs/core-devs/governance-fixtures.md similarity index 100% rename from docs/core-devs/governance-fixtures.todo rename to docs/core-devs/governance-fixtures.md diff --git a/docs/core-devs/move-coding-conventions.todo b/docs/core-devs/move-coding-conventions.md similarity index 100% rename from docs/core-devs/move-coding-conventions.todo rename to docs/core-devs/move-coding-conventions.md diff --git a/docs/core-devs/smoke-tests.todo b/docs/core-devs/smoke-tests.md similarity index 100% rename from docs/core-devs/smoke-tests.todo rename to docs/core-devs/smoke-tests.md diff --git a/docs/core-devs/testnet-deploy.todo b/docs/core-devs/testnet-deploy.md similarity index 100% rename from docs/core-devs/testnet-deploy.todo rename to docs/core-devs/testnet-deploy.md diff --git a/docs/cli-tools/txs/publish.todo b/docs/core-devs/testnet-depoloy-publish.todo similarity index 100% rename from docs/cli-tools/txs/publish.todo rename to docs/core-devs/testnet-depoloy-publish.todo diff --git a/docs/misc/tool-design.todo b/docs/core-devs/tool-design.todo similarity index 100% rename from docs/misc/tool-design.todo rename to docs/core-devs/tool-design.todo diff --git a/docs/misc/_category_.json b/docs/misc/_category_.json deleted file mode 100644 index 9c036af7..00000000 --- a/docs/misc/_category_.json +++ /dev/null @@ -1,8 +0,0 @@ -{ - "label": "Transactions", - "position": 2, - "link": { - "type": "generated-index", - "description": "Helpful instructions for submitting transactions" - } -} diff --git a/docs/misc/hot-upgrades.todo b/docs/misc/hot-upgrades.todo deleted file mode 100644 index 2a496885..00000000 --- a/docs/misc/hot-upgrades.todo +++ /dev/null @@ -1,161 +0,0 @@ - -# Network Hot Upgrades - -## Overview - -The "framework" which contains all the consensus, account, econ policies, etc. for the network is written in Move. This code is stored in the network database, and effectively executed on demand. This means that framework upgrades can occur without redeploying the Move VM itself, or the supporting system code (network node software). It also means the state machine can upgrade without a coordinated halt. - -- To do this we require the `libra` and `libra-framework` cli tools. The command `libra-framework` is used for building the artifacts, and `libra txs` for proposing, voting, and ultimately deploying the artifacts. - -## Historical Upgrade Information and Proposing Upgrades -Historical upgrade information since release 7.0.0 is canonically stored in the [upgrade repository](https://github.com/0LNetworkCommunity/upgrades). To submit an upgrade proposal, you should draft a PR with the relevant information detailing the upgrade using the provided [template](https://github.com/0LNetworkCommunity/upgrades/tree/main/proposals/template) and include the upgrade script packages. - - -## TLDR -- **Fetch the latest release**: `cd libra-framework; git fetch --all; git checkout release-x.x.x` -- **Build framework**: `libra-framework upgrade --output-dir ~/framework_upgrade --framework-local-dir ~/libra-framework/framework/` -- **Propose**: `libra txs governance propose --proposal-script-dir ~/framework_upgrade/1-move-stdlib/ --metadata-url https://github.com/0LNetworkCommunity/upgrades/tree/main/proposals/template` -- **Validators vote**: `libra txs governance vote --proposal-id ` -- **Resolve**: - - 1. `libra txs governance resolve --proposal-script-dir ~/framework_upgrade/1-move-stdlib/ --proposal-id 0` - - 2. `libra txs governance resolve --proposal-script-dir ~/framework_upgrade/2-vendor-stdlib/ --proposal-id 0` - - 3. `libra txs governance resolve --proposal-script-dir ~/framework_upgrade/3-libra-framework/ --proposal-id 0` - -## Upgrade Types: Single and Multiple - -When performing upgrades within the network framework, two primary approaches can be employed: single and multiple module upgrades. The key distinction lies in how these upgrades are proposed, voted on, and executed, particularly with respect to handling multiple modules. - -### Single Framework Upgrade -A single framework upgrade involves updating a singular set of modules within the framework. This process is straightforward and includes the following steps: - -- **Build Framework**: Generate the upgrade Move transaction scripts for the module. -- **Proposal Submission**: Propose the upgrade for the specific framework module. -- **Validator Voting**: Validators within the network vote for or against the proposed upgrade. -- **Achieving Consensus**: The proposal moves forward once it receives support from at least 66% of active validators. -- **Resolution and Deployment**: Resolve the proposal using the exact framework directory that matches the build of the proposed upgrade. This can be done by any validator using the same release branch from the `libra-framework` repository - -### Multiple Framework Upgrades -Multiple framework upgrades require a more nuanced approach, especially regarding resolution stages, to ensure a coherent and secure update across several modules. - -- **Build Framework**: Similar to a single upgrade, start by generating Move transaction scripts for all relevant modules. -- **Proposal for Initial Module**: Propose the upgrade by using the first module (`1-move-stdlib`). This initial proposal is critical as it kickstarts the governance process for the entire upgrade. - -Importantly, the transaction script for upgrading this first module includes a significant addition: **the transaction hash for the subsequent modules** that needs upgrading. These hashes, produced during the artifact building phase, serve as secure identifiers for each module's upgrade script. - -- **Validator Voting**: As with single upgrades, validators vote for or against the proposed upgrade. -- **Achieving Consensus and Sequential Resolution**: Once at least 66% of active validators support the proposal, the initial upgrade can be resolved. -- **Sequential Upgrade Execution**: Execute the resolution process for all involved modules, following the order 1-3. - - -## Upgrade Policy -The diem framework has information in the metadata that controls the policy that a publisher can set for upgrading their modules. These are: -- Arbitrary(0): Allows code upgrades without compatibility checks, for non-shared packages. -- Compatible(1): Requires compatibility checks to ensure no breaking changes in public functions or resource layouts. -- Immutable(2): Prevents any upgrades, ensuring the permanence of critical code. - -Due to some circumstances, a publisher may want to downgrade the policy to allow changes to go through that a restrictive policy would not allow. We can do this by building the framework with a flag(`--danger-force-upgrade`) that sets the upgrade policy as Aribitrary - -Example - -``` -libra txs governance propose --proposal-script-dir ~/framework_upgrade/3-libra-framework/ --metadata-url https://www.github.com/0LNetworkCommunity/UpdateProposalTemplate --danger-force-upgrade -``` - -## Procedure - -We will use this guide to do a multi-step upgrade as this is the most common upgrade that is done. - -### Build Artifacts - -##### 1. Build the upgrade Move transaction scripts - -This will be a Move package which is machine-generated for a one-time execution. It contains bytecode which will be allowed to be executed (by anyone), once there is a vote and agreement on the proposal passing. The on-chain execution is guarded with a hash of this transaction, which the proposer provides in the proposal transaction (in advance of the vote). - -An upgrade script that is tampered with will yield a different execution hash, and will be prevented from running (it is likely to be blocked by the transaction size limits before entering the mempool). - -The `libra-framework upgrade` command will produce a newly compiled Move upgrade transaction script, its binary, and the hash. - -You need to provide: -- `--output-dir`: this directory the upgrade transaction files should be saved to. A new folder called `framework_upgrade` will be created under the output-dir path. - -- `--framework-local-dir`: the source code for the framework so that the transaction script can import it as a dependency. - -Optionally you could provide the flag `--danger-force-upgrade - -``` -# Note the paths -libra-framework upgrade --output-dir --framework-local-dir - -# Example -libra-framework upgrade --output-dir ~/framework_upgrade --framework-local-dir ~/libra-framework/framework/ -``` -:::note -This creates 3 seperate library upgrade script directories -- 1-move-stdlib -- 2-vendor-stdlib -- 3-libra-framework - -You will choose depending on which library you want updated -::: - -All the artifacts are now created, the proposal transaction can be submitted. But it's a good idea to document this on github first. - -##### 2. Share the output artifacts on Github. - -Create a new repository with the outputted directory. Add a README.md file. - -The proposer can add the link to this Github repo in the proposal phase. - - -### Upgrade Ceremony - -##### 3. With `txs` anyone (no authority needed) can submit the proposal and metadata. You'll need to provide the actual script compiled path, and an optional URL which contains documentation of the proposal (e.g github). - -``` -# note the actual script dir -libra txs governance propose --proposal-script-dir --metadata-url - -# Example -libra txs governance propose --proposal-script-dir ~/framework_upgrade/1-move-stdlib/ --metadata-url https://www.github.com/0LNetworkCommunity/UpdateProposalTemplate - -``` -If this transaction succeeds it will produce a proposal id, which is a number. Now the proposal is open to voting. - -:::note -You can query the next proposal using this command: ` libra query view --function-id 0x1::diem_governance::get_next_governance_proposal_id` -::: - -##### 4. With `libra txs` anyone with governance authority (the epoch's validators as of `V7`), can submit a vote in favor (or against it with `--should-fail`). - -We assume the default is to vote in favor. To vote "approve" simply: -``` -libra txs governance vote --proposal-id -``` - -If voter would like the proposal to be rejected: -``` -libra txs governance vote --proposal-id --should-fail -``` -:::note -You can query to see the for and against votes using this command: ` libra query view --function-id 0x1::diem_governance::get_votes --args ` -::: - -After everyone has voted (to reach the consensus threshold of 66% as of `V7`), the proposal will be in a "Resolvable" state. Anyone can resolve it by submitting the upgrade transaction. This means the sender must have the source transaction script for the upgrade (step #1 above). - -##### 6. Use `txs` to resolve a successfully approved proposal -``` -# Note the actual path -libra txs governance resolve --proposal-script-dir --proposal-id - -# Example - 1. libra txs governance resolve --proposal-script-dir ~/framework_upgrade/1-move-stdlib/ --proposal-id 0 - - 2. libra txs governance resolve --proposal-script-dir ~/framework_upgrade/2-vendor-stdlib/ --proposal-id 0 - - 3. libra txs governance resolve --proposal-script-dir ~/framework_upgrade/3-libra-framework/ --proposal-id 0 -``` - -If this transaction is successful the new bytecode will be written to the VM diff --git a/docs/validators/detailed-instructions.todo b/docs/validators/detailed-instructions.md similarity index 100% rename from docs/validators/detailed-instructions.todo rename to docs/validators/detailed-instructions.md diff --git a/docs/validators/getting-started.todo b/docs/validators/getting-started.md similarity index 100% rename from docs/validators/getting-started.todo rename to docs/validators/getting-started.md diff --git a/docs/validators/hot-upgrades.todo b/docs/validators/hot-upgrades.md similarity index 100% rename from docs/validators/hot-upgrades.todo rename to docs/validators/hot-upgrades.md diff --git a/docs/validators/rescue.todo b/docs/validators/rescue.md similarity index 100% rename from docs/validators/rescue.todo rename to docs/validators/rescue.md diff --git a/docs/misc/sybil-resistance.todo b/docs/validators/sybil-resistance.md similarity index 100% rename from docs/misc/sybil-resistance.todo rename to docs/validators/sybil-resistance.md diff --git a/docs/validators/validator-quickstart.todo b/docs/validators/validator-quickstart.md similarity index 100% rename from docs/validators/validator-quickstart.todo rename to docs/validators/validator-quickstart.md diff --git a/docs/validators/vfn-setup.todo b/docs/validators/vfn-setup.md similarity index 100% rename from docs/validators/vfn-setup.todo rename to docs/validators/vfn-setup.md diff --git a/docs/validators/with-docker-setup.todo b/docs/validators/with-docker-setup.md similarity index 100% rename from docs/validators/with-docker-setup.todo rename to docs/validators/with-docker-setup.md diff --git a/docs/validators/yaml-templates/fullnode-yaml.todo b/docs/validators/yaml-templates/fullnode-yaml.md similarity index 100% rename from docs/validators/yaml-templates/fullnode-yaml.todo rename to docs/validators/yaml-templates/fullnode-yaml.md diff --git a/docs/validators/yaml-templates/validator-yaml.todo b/docs/validators/yaml-templates/validator-yaml.md similarity index 100% rename from docs/validators/yaml-templates/validator-yaml.todo rename to docs/validators/yaml-templates/validator-yaml.md diff --git a/docs/validators/yaml-templates/vfn-yaml.todo b/docs/validators/yaml-templates/vfn-yaml.md similarity index 100% rename from docs/validators/yaml-templates/vfn-yaml.todo rename to docs/validators/yaml-templates/vfn-yaml.md