GitBook: [#20] New Docs Structure

Author: dneorej

.gitbook/assets/Persistence Ecosystem.jpeg

@@ -1,11 +1,42 @@
-# What is Proof of Stake
+---
+description: Understand, Explore and Build the Persistence Liquid Staking Hub
+layout: landing
+---
 
-In PoS, the network is secured not by the resource-intensive work of hundreds of miners, but rather by **validators** locking, or ‘staking’ large quantities of the network’s native cryptocurrency. This allows validators to participate in the validation process of new blocks, as well as entitling them to receive smaller amounts of the currency in periodic rewards.
+# 👓 Overview
 
-The core idea here is that if someone locks up significant funds within the network, then, by extension, they care about the overall health and validity of the network, i.e. their interests are aligned with the collective. An insecure network’s token will lose value, and consequently, the validator’s stake will also lose value. To add to this, validators are also kept in check by a penalty for illegal or malicious behaviour, which takes away a portion of their [staked tokens](https://academy.stakedao.org/what-is-staking/).
+Welcome to Persistence Docs! Here you can find anything and everything related to the Persistence Liquid Staking Hub. We invite you to Learn, Participate, Explore, Build, Integrate, Validate and Connect with us on this journey. 
 
-PoS is designed to be a lot more energy efficient than [PoW](https://academy.stakedao.org/what-is-proof-of-work/), and also broadens the opportunity for the public to participate in mining for the network. Users without the necessary funds to become a validator themselves are able to delegate their tokens to a validator in exchange for a proportion of the rewards earned for securing the network.
-
-{% hint style="info" %}
-**Good to know:** Splitting your product into fundamental concepts, objects, or areas can be a great way to let readers deep dive into the concepts that matter most to them.
+{% hint style="warning" %}
+<mark style="color:red;">Note: This new Persistence Docs is still in a draft stage. We apologise if the information you're looking for is not yet available. Feel free to contribute to make it better, or please reach out to the team directly with any questions you might have.</mark>&#x20;
 {% endhint %}
+
+## Learn 📖
+
+The perfect place to build context in case you're just getting started
+
+<table data-view="cards"><thead><tr><th align="center"></th><th></th><th data-hidden data-card-target data-type="content-ref"></th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td align="center"><strong>Introduction</strong></td><td>About Persistence, the why, the problem statement and the offered solutions</td><td><a href="learn/introduction.md">introduction.md</a></td><td></td></tr><tr><td align="center"><strong>Ecosystem Overview</strong></td><td>Explore the various parts of the Liquid Staking Hub</td><td><a href="learn/ecosystem-overview.md">ecosystem-overview.md</a></td><td></td></tr><tr><td align="center"><strong>Foundation</strong></td><td>To foster a flourishing Liquid Staking Ecosystem by driving utility to $XPRT</td><td><a href="learn/persistence-foundation.md">persistence-foundation.md</a></td><td></td></tr><tr><td align="center"><strong>Labs</strong></td><td>Driving product innovation, applications and tools for the Persistence Network. </td><td><a href="learn/persistence-labs.md">persistence-labs.md</a></td><td></td></tr><tr><td align="center"><strong>Fundamentals</strong></td><td>Some basic concepts to get you started</td><td><a href="learn/fundamentals/">fundamentals</a></td><td></td></tr></tbody></table>
+
+## Participate & Explore 🔍
+
+Your participation matters! Read all about how you can participate in the Persistence ecosystem, and explore all the tools available to help you do so. &#x20;
+
+<table data-view="cards"><thead><tr><th align="center"></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>$XPRT</strong></td><td>Find out how to acquire and stake the native ecosystem token and use it in Governance and DeFi.</td><td><a href="participate/xprt/stake.md">stake.md</a></td></tr><tr><td align="center"><strong>Discuss</strong></td><td>Engage in discussions, come up with new ideas, challenge the status quo</td><td><a href="broken-reference">Broken link</a></td></tr><tr><td align="center"><strong>Wallets</strong></td><td>Find out which wallets to use to interact with the Persistence chain</td><td><a href="participate/wallets.md">wallets.md</a></td></tr><tr><td align="center"><strong>Explorers</strong></td><td>Your options to find the on-chain data you need</td><td><a href="participate/explorers.md">explorers.md</a></td></tr><tr><td align="center"><strong>Analytics</strong></td><td>Some interesting analytics dashboards</td><td><a href="participate/analytics.md">analytics.md</a></td></tr><tr><td align="center"><strong>Bridges</strong></td><td>Your options for bridging assets into or out of Persistence</td><td><a href="participate/bridges.md">bridges.md</a></td></tr></tbody></table>
+
+## Build, Integrate, Validate ⚒️
+
+Technical Documentation for builders & validators
+
+<table data-view="cards"><thead><tr><th align="center"></th><th></th><th data-hidden data-card-target data-type="content-ref"></th></tr></thead><tbody><tr><td align="center"><strong>Nodes &#x26; Endpoints</strong></td><td>Public Nodes &#x26; Endpoints, and how to run a node on testnet or mainnet</td><td><a href="build/nodes-and-endpoints/">nodes-and-endpoints</a></td></tr><tr><td align="center"><strong>Validators</strong></td><td>How to become a validator on testnet or mainnet</td><td><a href="build/validators/">validators</a></td></tr><tr><td align="center"><strong>Relayers</strong></td><td>Which relayers are maintained, and how to run one yourself</td><td><a href="build/relayers/">relayers</a></td></tr><tr><td align="center"><strong>Indexers</strong></td><td>How to connect to and even run Graph Nodes</td><td><a href="build/indexers/">indexers</a></td></tr><tr><td align="center"><strong>Smart Contracts</strong></td><td>How to build Dapps on top of the Persistence Chain via CosmWasm</td><td><a href="build/smart-contracts/">smart-contracts</a></td></tr><tr><td align="center"><strong>Modules</strong></td><td>Understand the current modules and how to leverage them</td><td><a href="build/tools/">tools</a></td></tr><tr><td align="center"><strong>Tools</strong></td><td>Find all tools that have been built for the ecosystem</td><td><a href="build/modules/">modules</a></td></tr><tr><td align="center"><strong>Contribute</strong></td><td>How to contribute to the persistence ecosystem</td><td><a href="build/contribute.md">contribute.md</a></td></tr><tr><td align="center"><strong>Grants</strong></td><td>How to get support &#x26; funding from the Foundation</td><td><a href="broken-reference">Broken link</a></td></tr></tbody></table>
+
+## Connect & Follow 😍
+
+Find all links to the Persistence official pages and channels [on this page](connect-and-follow.md)
+
+
+
+
+
+
+
+**Disclaimer:** _While this docs page is provided and maintained as a collaborative effort between Persistence Labs & the Persistence Foundation, there is no guarantee that all presented information is up-to-date at all times. We invite the community to flag any errors or inaccuracies and contribute to keeping the docs up-to-date._&#x20;

.gitbook/assets/XPRT Role (1).png

@@ -1,60 +1,71 @@
 # Table of contents
 
-## Intro
-
-* [What is Proof of Stake](README.md)
-* [What is Cosmos](Intro/what-is-cosmos.md)
-* [What is Liquid Staking](Intro/what-is-liquid-staking.md)
-* [What is DeFi](Intro/what-is-defi.md)
-* [What is Persistence One?](<README (1).md>)
-  * [Why Persistence?](Intro/why-persistence.md)
-  * [What is pSTAKE?](Intro/what-is-pstake.md)
-
-## pSTAKE
-
-* [Staked Cosmos Assets](pstake/cosmos-assets.md)
-
-## Chain
-
-* [Creating a Wallet](Chain/creating-a-wallet.md)
-* [Governance](Chain/governance.md)
-* [Setup](Chain/setup.md)
-* [Mainnet Validator](Chain/mainnet-validator-setup.md)
-* [Testnet Validator](Chain/testnet-validator-setup.md)
-
-
-
-## Contracts
-
-* [Overview](Contracts/overview.md)
-* [Uploading a Contract](Contracts/uploading-a-contract.md)
-* [Interacting with a Contract](Contracts/interacting-with-contracts.md)
-
-## 📘 Guides
-
-* [Stake $XPRT](guides/stake-usdxprt.md)
-* [Provide Liquidity](guides/provide-liquidity.md)
-
-## 💻 Technology
-
-* [Grants](technology/grants.md)
-* [Validators](technology/validators.md)
-* [Audits](technology/audits.md)
-* [Persistence SDK](technology/persistence-sdk.md)
-
-## 🪙 Tokens
-
-* [$XPRT](tokens/usdxprt.md)
-* [$PSTAKE](tokens/usdpstake.md)
-* [$XPRT-$PSTAKE Relationship](tokens/usdxprt-usdpstake-relationship.md)
-
-## Links
-
-* [Website](https://persistence.one)
-* [Github](https://github.com/persistenceOne)
-* [Blog](https://medium.com/persistence-blog)
-
-## Ecosystem
-
-* [Bamboo](ecosystem/Dexter.md)
-* [Dexter](ecosystem/dexter.md)
+* [👓 Overview](README.md)
+
+## 📖 Learn
+
+* [Introduction](learn/introduction.md)
+* [Ecosystem Overview](learn/ecosystem-overview.md)
+* [Persistence Foundation](learn/persistence-foundation.md)
+* [Persistence Labs](learn/persistence-labs.md)
+* [Fundamentals](learn/fundamentals/README.md)
+  * [What is Proof-of-Stake](learn/fundamentals/what-is-proof-of-stake.md)
+  * [What is Cosmos](learn/fundamentals/what-is-cosmos.md)
+  * [What is DeFi](learn/fundamentals/what-is-defi.md)
+  * [What is Liquid Staking](learn/fundamentals/what-is-liquid-staking.md)
+
+## 🔍 Participate & Explore <a href="#participate" id="participate"></a>
+
+* [$XPRT Token](participate/xprt/README.md)
+  * [Acquire](participate/xprt/acquire.md)
+  * [Stake](participate/xprt/stake.md)
+  * [Governance](participate/xprt/governance.md)
+  * [DeFi](participate/xprt/defi/README.md)
+    * [Provide Liquidity](participate/xprt/defi/provide-liquidity.md)
+    * [Liquid Stake](participate/xprt/defi/liquid-stake.md)
+    * [Borrow / Lend](participate/xprt/defi/borrow-lend.md)
+* [Wallets](participate/wallets.md)
+* [Explorers](participate/explorers.md)
+* [Analytics](participate/analytics.md)
+* [Bridges](participate/bridges.md)
+
+## ⚒ Build, Integrate, Validate <a href="#build" id="build"></a>
+
+* [Nodes & Endpoints](build/nodes-and-endpoints/README.md)
+  * [Public Infrastructure](build/nodes-and-endpoints/public-infrastructure.md)
+  * [Setup a node](build/nodes-and-endpoints/setup.md)
+  * [Set up a local testnet](build/nodes-and-endpoints/set-up-a-local-testnet.md)
+  * [Join Testnet](build/nodes-and-endpoints/join-testnet.md)
+  * [Join Mainnet](build/nodes-and-endpoints/join-mainnet.md)
+* [Validators](build/validators/README.md)
+  * [Validate on Mainnet](build/validators/mainnet-validator-setup.md)
+  * [Validate on Testnet](build/validators/testnet-validator-setup.md)
+  * [Validator Communication](build/validators/validator-communication.md)
+  * [Foundation Delegations](build/validators/foundation-delegations/README.md)
+    * [Round 1](build/validators/foundation-delegations/round-1.md)
+* [Relayers](build/relayers/README.md)
+  * [IBC Channels](build/relayers/ibc-channels.md)
+  * [IBC Relayers](build/relayers/ibc-relayers.md)
+  * [Relay on Mainnet](build/relayers/relay-on-mainnet.md)
+  * [Relay on Testnet](build/relayers/relay-on-testnet.md)
+* [Indexers](build/indexers/README.md)
+  * [Connect to a Subgraph](build/indexers/connect-to-a-subgraph.md)
+  * [Run a Subgraph](build/indexers/run-a-subgraph.md)
+  * [Run a Graph Firehose](build/indexers/run-a-graph-firehose.md)
+* [Smart Contracts](build/smart-contracts/README.md)
+  * [Overview](build/smart-contracts/overview.md)
+  * [Uploading a Contract](build/smart-contracts/uploading-a-contract.md)
+  * [CosmWasm](build/smart-contracts/cosmwasm.md)
+* [Modules](build/modules/README.md)
+  * [pSTAKE module](build/modules/pstake-module.md)
+  * [Epochs module](build/modules/epochs-module.md)
+* [Tools](build/tools/README.md)
+  * [Persistence JS](build/tools/persistence-js.md)
+  * [Persistence SDK](build/tools/persistence-sdk.md)
+  * [Persistence CLI](build/tools/persistence-cli.md)
+* [Contribute](build/contribute.md)
+* [Grants](build/grants.md)
+
+***
+
+* [😍 Connect & Follow](connect-and-follow.md)

.gitbook/assets/XPRT Role.png

@@ -0,0 +1,7 @@
+---
+description: All contributions to the documentation & tooling are greatly appreciated
+---
+
+# Contribute
+
+<mark style="color:red;">Section to be reviewed and updated</mark>