tweaks

developers/README.md

@@ -6,7 +6,7 @@ coverY: 0
 
 # 👨💻 Developers
 
-### What can you build with Ocean?
+## What can you build with Ocean?
 
 1. **Token-gated dApps & REST APIs**: monetize by making your dApp or its REST API token-gated. [Here's how](https://github.com/oceanprotocol/token-gating-template).
 1. **AI dApps**: monetize your AI dApp by token-gating on AI training data, feature vectors, models, or predictions.
@@ -18,25 +18,25 @@ Example live dapps:
 - **Token-gated dapps**: [Autobot](https://autobotocean.com/) for analytics, and [Ocean Waves](https://waves.oceanprotocol.com/) for music.
 - **Token-gated feeds**: [Ocean Predictoor](https://predictoor.ai) for AI prediction feeds
 
-### How do developers start using Ocean?
+## How do developers start using Ocean?
 
 - **App level: [Use an Ocean Template](https://oceanprotocol.com/templates)**.
 - **Library level: [Use ocean.js](ocean.js/README.md)** is a library built for the key environment of dApp developers: JavaScript. Import it & use it your frontend or NodeJS.
-- **Contract level: [Call Ocean contracts](contracts.md)** on Eth mainnet [or other chains](../discover/networks.md).
+- **Contract level: [Call Ocean contracts](contracts/README.md)** on Eth mainnet [or other chains](../discover/networks/README.md).
 
-### Developer Docs Quick-links
+## Developer Docs Quick-links
 
 - [Architecture](architecture.md) - blockchain/contracts layer, middleware, dapps
-- Earning revenue: [code to get payment](revenue.md), [fractional $](fractional-ownership.md), [community $](community-monetization)
+- Earning revenue: [code to get payment](contracts/revenue.md), [fractional $](fractional-ownership.md), [community $](community-monetization.md)
 - Schemas: [Metadata](metadata.md), [identifiers/DIDs](identifiers.md), [identifier objects/DDOs](ddo-specification.md), [storage](storage.md), [fine-grained permissions](fg-permissions.md)
 - Components:
-  - [Barge](barge.md) - local chain for testing
-  - [Ocean subgraph](subgraph.md) - grabbing event data from the chain
-  - [Ocean CLI](ocean-cli.md) - command-line interface
-  - [Compute-to-data](compute-to-data.md) - practical privacy approach
-  - [Aquarius](aquarius.md) - metadata cache
-  - [Provider](provider.md) - handshaking for access control
-- [FAQ](faq.md) 
+  - [Barge](barge/README.md) - local chain for testing
+  - [Ocean subgraph](subgraph/README.md) - grabbing event data from the chain
+  - [Ocean CLI](ocean-cli/README.md) - command-line interface
+  - [Compute-to-data](compute-to-data/README.md) - practical privacy approach
+  - [Aquarius](aquarius/README.md) - metadata cache
+  - [Provider](provider/README.md) - handshaking for access control
+- [FAQ](dev-faq.md) 
 
 ----
 

discover/faq.md

@@ -1,6 +1,6 @@
 ---
 title: FAQs
-description: Frequently Asked Questions about Ocean Protocol
+description: 
 ---
 
 # FAQ

user-guides/README.md

@@ -1,7 +1,6 @@
 ---
 description: >-
-  The definitive guides on how to do almost anything you want with Ocean
-  Protocol tech!
+  Guides to use Ocean, with no coding needed.
 cover: ../.gitbook/assets/cover/user_guides_banner.png
 coverY: 0
 ---
@@ -10,8 +9,6 @@ coverY: 0
 
 <figure><img src="../.gitbook/assets/gif/follow-instructions.gif" alt="" width="375"><figcaption></figcaption></figure>
 
-These are guides to use Ocean, with no coding needed.
-
 **Contents:**
 - Basic concepts
 - Using wallets
@@ -39,8 +36,8 @@ For blockchain beginners
 [wallets/metamask-setup.md](wallets/metamask-setup.md)
 {% endcontent-ref %}
 
-{% content-ref url="wallets-and-ocean.md" %}
-[wallets-and-ocean.md](wallets-and-ocean.md)
+{% content-ref url="wallets/wallets-and-ocean.md" %}
+[wallets-and-ocean.md](wallets/wallets-and-ocean.md)
 {% endcontent-ref %}