diff --git a/discover/benefits.md b/discover/benefits.md
index b142656c..db140b25 100644
--- a/discover/benefits.md
+++ b/discover/benefits.md
@@ -5,10 +5,12 @@ description:
# What can you do with Ocean?
This page shows things you can do with Ocean...
-- [As a builder](#what-builders-can-do)
-- [As a data scientist](#what-data-scientists-can-do)
-- [As an OCEAN holder](#what-ocean-holders-can-do)
-- [Become an Ocean ambassador](#become-an-ocean-ambassador)
+- As a builder
+- As a data scientist
+- As an OCEAN holder
+- Become an Ocean ambassador
+
+Let's explore each...
### What builders can do
diff --git a/discover/networks/README.md b/discover/networks/README.md
index be176027..05761fbd 100644
--- a/discover/networks/README.md
+++ b/discover/networks/README.md
@@ -16,20 +16,20 @@ You need the network's native token to pay for gas to make transactions: ETH for
Here are the networks that Ocean is deployed to.
**Production Networks:**
-- [Ethereum mainnet](#ethereum-mainnet)
-- [Polygon mainnet](#polygon-mainnet)
-- [Oasis Sapphire mainnet](#oasis-sapphire-mainnet)
-- [BNB Smart Chain](#bnb-smart-chain)
-- [Energy Web Chain](#energy-web-chain)
-- [Optimism Mainnet](#optimism-mainnet)
-- [Moonriver](#moonriver)
+- Ethereum mainnet
+- Polygon mainnet
+- Oasis Sapphire mainnet
+- BNB Smart Chain
+- Energy Web Chain
+- Optimism Mainnet
+- Moonriver
**Test Networks:**
-- [Görli](#görli)
-- [Sepolia](#sepolia)
-- [Mumbai](#mumbai)
-- [Oasis Sapphire testnet](#oasis-sapphire-testnet)
-- [Optimism Sepolia](#optimism-sepolia)
+- Görli
+- Sepolia
+- Mumbai
+- Oasis Sapphire testnet
+- Optimism Sepolia
The rest of this doc gives details for each network. You can skip it until you need the reference information.
diff --git a/discover/networks/bridges.md b/discover/networks/bridges.md
index 392c7c94..51ff5ef7 100644
--- a/discover/networks/bridges.md
+++ b/discover/networks/bridges.md
@@ -8,8 +8,8 @@ description: Transfer tokens between two blockchain networks.
A bridge is a mechanism that connects two or more separate blockchain networks, enabling communication and interoperability between them. Bridges can be designed to facilitate the transfer of assets, data, or messages between different blockchain networks that may operate on different protocols, and consensus mechanisms, or have different native currencies.
This page covers:
-- [Celer Bridge](#celer-bridge) - bridge OCEAN from Eth mainnet <> Oasis Sapphire mainnet
-- [BNB Smart Chain Bridge](#bnb-smart-chain-bridge) - bridge OCEAN from Eth mainnet <> BNB Smart Chain
+- **Celer Bridge** - bridge OCEAN from Eth mainnet <> Oasis Sapphire mainnet
+- **BNB Smart Chain Bridge** - bridge OCEAN from Eth mainnet <> BNB Smart Chain
For other bridges and networks, see the [Networks page](README.md).
diff --git a/discover/ocean-token.md b/discover/ocean-token.md
index 51901187..ea4108ce 100644
--- a/discover/ocean-token.md
+++ b/discover/ocean-token.md
@@ -7,12 +7,11 @@ description:
OCEAN is a utility token. It's used to stake on data for curation, buy & sell data, and more. Its supply is disbursed over time to drive near-term growth and long-term sustainability.
**Contents:**
-- [Getting and storing OCEAN](#getting-and-storing-ocean)
-- [Staking OCEAN](#staking-ocean)
-- [OCEAN supply](#ocean-supply)
-- [Token design](#ocean-token-design)
-- [OCEAN addresses](#ocean-addresses)
-
+- Getting and storing OCEAN
+- Staking OCEAN
+- OCEAN supply
+- Token design
+- OCEAN addresses
diff --git a/discover/what-is-ocean.md b/discover/what-is-ocean.md
index 20c2f4a4..485bf3c2 100644
--- a/discover/what-is-ocean.md
+++ b/discover/what-is-ocean.md
@@ -7,12 +7,12 @@ description:
Ocean is a decentralized data exchange protocol and community.
Specifically, it has two parts:
-- A live tech stack. At the core is [Datatokens](#ocean-data-nfts-and-datatokens) and [Compute-to-Data](#ocean-compute-to-data)
-- A lively community. This includes [builders, data scientists, OCEAN holders](#ocean-ecosystem), and [Ocean Ambassadors](#ocean-ambassadors)
+- A live tech stack. At the core is **Datatokens** and **Compute-to-Data**
+- A lively community. This includes **builders, data scientists, OCEAN holders**, and **Ocean Ambassadors**
Let's drill into each.
-### Ocean data NFTs and datatokens
+### Tech: Ocean data NFTs and datatokens
These enable decentralized access control, via token-gating. Key principles:
@@ -26,7 +26,7 @@ Crypto wallets, exchanges, and DAOs become _data_ wallets, exchanges, and DAOs.
Data can be on Azure or AWS, Filecoin or Arweave, REST APIs or smart contract feeds. Data may be raw AI training data, feature vectors, trained models, even AI model predictions, or non-AI data.
-### Ocean Compute-to-Data
+### Tech: Ocean Compute-to-Data
This enables one buy & sell private data, while preserving privacy
- Private data is valuable: using it can improve research and business outcomes. But concerns over privacy and control make it hard to access.
@@ -38,7 +38,7 @@ This enables one buy & sell private data, while preserving privacy
-### Ocean Ecosystem
+### Community: Ocean Ecosystem
Ocean has a lively [ecosystem](https://oceanprotocol.com/explore/ecosystem) of dapps grown over years, built by enthusiastic developers.
@@ -46,7 +46,7 @@ Ocean has a lively [ecosystem](https://oceanprotocol.com/explore/ecosystem) of d
The Ocean ecosystem also contains many data scientists and OCEAN holders, excited about the future of AI & data. You can find them doing predictions, data challenges, Data Farming, and more.
-### Ocean Ambassadors
+### Community: Ocean Ambassadors
Ocean has an excellent [community of ambassadors](https://oceanprotocol.com/explore/community). Anyone can join.
diff --git a/user-guides/README.md b/user-guides/README.md
index 8ae18d8f..8dabe4d0 100644
--- a/user-guides/README.md
+++ b/user-guides/README.md
@@ -13,11 +13,13 @@ coverY: 0
These are guides to use Ocean, with no coding needed.
**Contents:**
-- [Basic concepts](#basic-concepts)
-- [Using wallets](#using-wallets)
-- [Using Ocean Market](#using-ocean-market)
-- [C2D in Ocean Market](#c2d-in-ocean-market)
-- [Host assets](#host-assets)
+- Basic concepts
+- Using wallets
+- Using Ocean Market
+- C2D in Ocean Market
+- Host assets
+
+Let's dive in!
### Basic concepts