diff --git a/discover/benefits.md b/discover/benefits.md
index 98ac32d3..b0c34ee3 100644
--- a/discover/benefits.md
+++ b/discover/benefits.md
@@ -12,7 +12,7 @@ This page shows things you can do with Ocean...
Let's explore each...
-### What builders can do
+## What builders can do
@@ -47,7 +47,7 @@ Build a decentralized data marketplace by [forking Ocean Market code](../develop
To dive deeper, please go to [Developers page](../developers/README.md).
-### What data scientists can do
+## What data scientists can do
@@ -82,7 +82,7 @@ Ocean regularly offer [data science challenges](../data-scientists/join-a-data-c
To dive deeper, please go to [Data Scientists page](../data-scientists/README.md).
-### What OCEAN holders can do
+## What OCEAN holders can do
@@ -92,7 +92,7 @@ Ocean's [Data Farming](../data-farming/README.md) incentives program enables OCE
-### Become an Ocean Ambassador
+## Become an Ocean Ambassador
diff --git a/discover/faq.md b/discover/faq.md
index e22a4701..bf3ea0e3 100644
--- a/discover/faq.md
+++ b/discover/faq.md
@@ -9,7 +9,7 @@ Have some questions about Ocean Protocol?
Hopefully, you'll find the answers here! If not then please don't hesitate to reach out to us on [discord](https://discord.gg/TnXjkR5) - there are no stupid questions!
-### General
+## General
How is Ocean Protocol related to AI?
@@ -61,7 +61,7 @@ To be fully decentralized means no single point of control, at any level of the
-### About OCEAN
+## About OCEAN
How is OCEAN used? How does it capture value?
@@ -123,7 +123,7 @@ For each consume transaction, the Ocean community gets a small fee. This happens
-### Grants, challenges, and ecosystem
+## Grants, challenges, and ecosystem
Is Acentrik from Mercedes Benz built on top of Ocean?
@@ -153,7 +153,7 @@ There are a wide host of technical, business, and cultural barriers to overcome
-### Data security
+## Data security
@@ -172,7 +172,7 @@ This issue is similar to what any digital distribution platform faces. For insta
-### Data marketplaces & Ocean Market
+## Data marketplaces & Ocean Market
What is a decentralized data marketplace?
@@ -201,7 +201,7 @@ Ocean Market is a showcase for the practical application of Ocean, showing other
Fees are generated Ocean Market from Ocean Market that head to Ocean community. The earlier Q&A on revenue has details.
-### Contacting Ocean core team
+## Contacting Ocean core team
Who is the right person to talk to regarding a marketing proposal or collaboration?
diff --git a/discover/glossary.md b/discover/glossary.md
index 059f20f0..c0e917a9 100644
--- a/discover/glossary.md
+++ b/discover/glossary.md
@@ -5,7 +5,7 @@ description: >-
# Glossary
-### Ocean Protocol Concepts
+## Ocean Protocol Concepts
@@ -107,7 +107,7 @@ When a user allocates veOCEAN to Ocean Market projects, then weekly OCEAN reward
-### Intellectual Property (IP) Concepts
+## Intellectual Property (IP) Concepts
@@ -150,7 +150,7 @@ Transfer one (of many) sub-licenses to new licensee: ERC20.transfer(to=licensee,
-### Web3 Fundamentals
+## Web3 Fundamentals
@@ -318,9 +318,9 @@ A term used in the cryptocurrency and blockchain space to encourage developers a
-###
+##
-### Decentralized Finance (DeFi) fundamentals
+## Decentralized Finance (DeFi) fundamentals
@@ -402,7 +402,7 @@ A strategy in which investors provide liquidity to a DeFi protocol in exchange f
-### Data Science Terminology
+## Data Science Terminology
diff --git a/discover/networks/bridges.md b/discover/networks/bridges.md
index 218125d2..c16ea9a6 100644
--- a/discover/networks/bridges.md
+++ b/discover/networks/bridges.md
@@ -13,7 +13,7 @@ For other bridges and networks, see the [Networks page](README.md).
The rest of this doc gives bridging details. You can skip it until you need the reference information.
-## BNB Smart Chain Bridge
+### BNB Smart Chain Bridge
To transfer OCEAN to and from the BNB Smart Chain, we recommend using [Binance Bridge](https://www.bnbchain.org/en/bridge). BSC offers various options such as withdrawing crypto from [Binance](https://www.binance.com/en) and utilizing the [Binance Bridge](https://www.bnbchain.org/en/bridge). You can refer to the Binance Academy article "[How to Get Started with BSC](https://academy.binance.com/en/articles/how-to-get-started-with-binance-smart-chain-bsc)" for more information.
@@ -23,7 +23,7 @@ In case you opt for an alternative bridge option and intend to transfer tokens t
{% endhint %}
-## Polygon (ex Matic) Bridge
+### Polygon (ex Matic) Bridge
The Polygon Network (previously known as Matic) offers a [bridge](https://wallet.polygon.technology/bridge/), which lets you easily transfer digital assets between Ethereum and Polygon blockchains and a dedicated [wallet](https://wallet.polygon.technology/) designed for this purpose, which can be linked to your account through Metamask or other compatible wallets.
diff --git a/discover/ocean-token.md b/discover/ocean-token.md
index 5310a0ca..8e71bae6 100644
--- a/discover/ocean-token.md
+++ b/discover/ocean-token.md
@@ -16,17 +16,17 @@ OCEAN is a utility token. It's used to stake on data for curation, buy & sell da
-### Getting and Storing OCEAN
+## Getting and Storing OCEAN
OCEAN is available on most leading CEXes and DEXes. The [Ocean Token page at oceanprotocol.com](https://oceanprotocol.com/about-us/ocean-token) has details.
The [Wallets User Guide](../user-guides/wallets/README.md) here in Ocean docs shows how to set up wallets and store OCEAN.
-### Staking OCEAN
+## Staking OCEAN
You can lock OCEAN and earn rewards via [Ocean Data Farming](../data-farming/README.md).
-### OCEAN supply
+## OCEAN supply
Total # tokens: 1.41B. All tokens are minted; all control is [revoked](https://blog.oceanprotocol.com/control-over-the-ocean-contract-to-be-revoked-soon-overview-6c5b15be2db).
@@ -37,7 +37,7 @@ OCEAN supply is divided as follows:
- 10% (141.0M OCEAN) - to the founding company, and in turn to its investors, employees & operations
- 24% (338.4M OCEAN) - to token acquirors. This completed in early 2019. All acquiror vesting is complete as well.
-### OCEAN Token Design
+## OCEAN Token Design
The system-level design of the OCEAN token is based on [The Web3 Sustainability Loop](https://blog.oceanprotocol.com/the-web3-sustainability-loop-b2a4097a36e), a general design pattern. The Ocean-specific version of this design is described in [section (7) of that same article](https://blog.oceanprotocol.com/the-web3-sustainability-loop-b2a4097a36e#e0f6).
@@ -48,7 +48,7 @@ In the design, a % of revenue is used to buy back & burn OCEAN. The remaining %
-### OCEAN addresses
+## OCEAN addresses
The "root" OCEAN token is deployed on Ethereum mainnet with address [`0x967da4048cd07ab37855c090aaf366e4ce1b9f48`](https://etherscan.io/token/0x967da4048cd07ab37855c090aaf366e4ce1b9f48).
diff --git a/user-guides/README.md b/user-guides/README.md
index 8dabe4d0..eead4b4a 100644
--- a/user-guides/README.md
+++ b/user-guides/README.md
@@ -21,7 +21,7 @@ These are guides to use Ocean, with no coding needed.
Let's dive in!
-### Basic concepts
+## Basic concepts
For blockchain beginners
@@ -29,7 +29,7 @@ For blockchain beginners
[basic-concepts.md](basic-concepts.md)
{% endcontent-ref %}
-### Using wallets
+## Using wallets
{% content-ref url="wallets/README.md" %}
[wallets/README.md.md](wallets/README.md)
@@ -44,7 +44,7 @@ For blockchain beginners
{% endcontent-ref %}
-### Using Ocean Market
+## Using Ocean Market
{% content-ref url="using-ocean-market.md" %}
[using-ocean-market.md](using-ocean-market.md)
@@ -58,19 +58,19 @@ For blockchain beginners
[buy-data-nfts.md](buy-data-nfts.md)
{% endcontent-ref %}
-### C2D in Ocean Market
+## C2D in Ocean Market
{% content-ref url="compute-to-data/" %}
[compute-to-data](compute-to-data/README.md)
{% endcontent-ref %}
-### Host Assets
+## Host Assets
{% content-ref url="asset-hosting/" %}
[asset-hosting](asset-hosting/README.md)
{% endcontent-ref %}
-### Antique Stuff 🏺
+## Antique Stuff 🏺
If you have OCEAN in old pools, this will help.