diff --git a/docs/README.mdx b/docs/README.mdx index a23041825e..8de8ba458d 100644 --- a/docs/README.mdx +++ b/docs/README.mdx @@ -6,7 +6,7 @@ import {findSidebarItem} from '@site/src/sidebarUtils'; ## Use Oasis -The introductory section contains general overview of the Oasis Network such as +This introductory part contains general overview of the Oasis Network such as the distinction between the consensus layer and different ParaTimes. It also covers wallets and other tools for managing your assets across the Oasis chains and how to use unique Oasis features. @@ -14,6 +14,7 @@ chains and how to use unique Oasis features. ## Create dApp @@ -25,7 +26,7 @@ encryption**. The Oasis team also prepared a set of libraries called the [Oasis Privacy Layer] to **bridge existing dApps running on other chains** to use the unique Sapphire's confidentiality. -The section also covers other ParaTimes such as the non-confidential +The part also covers other ParaTimes such as the non-confidential [Oasis Emerald] and Wasm-compatible, confidential [Oasis Cipher]. ## Develop Core Whether you want to contribute your code to the core components of the Oasis -Network or just learn more about the Oasis core, this is the place for you. +Network or just learn more about the Oasis consensus layer and other core +components, this is the part for you. -Development of interoperable Oasis network components are made by consensus. -Similar to the Ethereum's ERC/EIP mechanism, Oasis follows Architectural -Decision Records (ADRs) which are first proposed, voted on and can then be -implemented, if accepted. +Additions or changes to the interoperable Oasis network components are always +made with consensus. Similar to the Ethereum's ERC/EIP mechanism Oasis follows +formal Architectural Decision Records (ADRs) which are first proposed, voted on +and finally implemented, if accepted. diff --git a/docs/general/README.mdx b/docs/general/README.mdx index 2cb4a598a0..4e3eab44a2 100644 --- a/docs/general/README.mdx +++ b/docs/general/README.mdx @@ -9,4 +9,5 @@ basic tools for you to get started. diff --git a/docs/node/run-your-node/non-validator-node.md b/docs/node/run-your-node/non-validator-node.md index b26b120d17..fc90860dcf 100644 --- a/docs/node/run-your-node/non-validator-node.md +++ b/docs/node/run-your-node/non-validator-node.md @@ -10,7 +10,7 @@ This guide will cover setting up your non-validator node for the Oasis Network. ## Prerequisites -Before following this guide, make sure you've followed the [Prerequisites](prerequisites) section and have the Oasis Node binary installed on your systems. +Before following this guide, make sure you've followed the [Prerequisites](prerequisites) chapter and have the Oasis Node binary installed on your systems. ### Creating a Working Directory diff --git a/docs/node/testnet/README.md b/docs/node/testnet/README.md index 93a27a0c41..d7384ae355 100644 --- a/docs/node/testnet/README.md +++ b/docs/node/testnet/README.md @@ -55,7 +55,7 @@ The Oasis Node is part of the Oasis Core release. ## ParaTimes -This section contains parameters for various ParaTimes known to be deployed on the Testnet. Similar to the Testnet, these may be subject to frequent version upgrades and/or state resets. +This chapter contains parameters for various ParaTimes known to be deployed on the Testnet. Similar to the Testnet, these may be subject to frequent version upgrades and/or state resets. ### Cipher