restructure & edits per meeting (#39)

* restructure & edits per meeting

* MD errors fixed

* fixed caps in headings

Author: Christian-MK

docs/FAQ/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "FAQ",
-    "position": 19
+    "position": 8
   }

docs/FAQ/faq-3.md

@@ -1,10 +1,10 @@
 ---
 id: faq-3
 sidebar_position: 3
-slug: /$FACT-launch
+slug: /$fact-launch
 ---
 
-# The $FACT Launch
+# The $FACT launch
 
 On September 8th 2023, Orcfax launched the $FACT utility token in collaboration
 with the Wingriders’ Launchpad, and quickly reached the max contributions,
@@ -20,7 +20,7 @@ came online with Wingriders.
 update -->
 Yield farming rewards are available on both Wingriders and Minswap.
 
-## What is the Fact policy ID?
+## What is the $FACT policy ID?
 
 It has been reported that multiple fake FACT tokens, and pools, have been
 found. **Always** check our FACT Policy ID before making any trades:

docs/FAQ/faq-4.md

@@ -1,10 +1,10 @@
 ---
 id: faq-4
 sidebar_position: 4
-slug: /Technical-questions
+slug: /technical-questions
 ---
 
-# Technical Questions
+# Technical questions
 
 ## What are the minimum technical requirements for node operations?
 

docs/Feeds/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "Feeds",
-    "position": 20
+    "position": 3
   }

docs/ITN/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "Developer manual",
-    "position": 10
+    "position": 4
   }

docs/cardano-network/Catalyst/_category_.json

@@ -1,17 +1,17 @@
 ---
-id: orcfax deployments
+id: protocol deployments
 sidebar_position: 3
 slug: /deployments
 ---
 
+# Protocol deployments
+
 <!-- note:
     Use &#x2011; to replace dashes below, e.g. for datetime stamps.
 
     2024-01-01 becomes 2024&#x2011;01&#x2011;01.
 -->
 
-# Protocol deployments
-
 The following documents current and historical deployments of the Orcfax
 protocol. The hashes can be used to navigate Orcfax Fact Statements and archival
 packages on Cardano and Arweave blockchains.
@@ -21,14 +21,14 @@ Integrators should consult the [integrator docs][consume] for an explanation
 an the role of different scripts used in the protocol and how to correctly use
 the Orcfax protocol.
 
-## V1
+## v1
 
-Orcfax V1 introduces the FSP (FactStatementPointer) script. The FSP will not
+Orcfax v1 introduces the FSP (FactStatementPointer) script. The FSP will not
 change in the lifetime of a deployment. The FSP is used to record the current
 FS (FactStatement) script hash. The FSP, FS, and C (Constitution) script
-hashes are documented below for each V1 deployment.
+hashes are documented below for each v1 deployment.
 
-### V1: Mainnet
+### v1: Mainnet
 
 A summary of mainnet deployments is listed below.
 
@@ -51,7 +51,7 @@ A per-FSP breakdown is documented below.
 | Slot no.         | -       |
 | Block            | -       |
 
-### V1: Preview
+### v1: Preview
 
 A summary of preview deployments is listed below.
 
@@ -78,7 +78,7 @@ A per-FSP breakdown is documented below.
 
 <br/>
 
-## V0
+## v0
 
 Orcfax V0 used a series of scripts built in collaboration with MLabs, the
 protocol itself was called the Cardano Open Oracle Protocol (COOP). For more
@@ -90,7 +90,7 @@ to interpret the data published on-chain using this version.
 For brevity, only the primary script hash used for publication using COOP is
 listed below.
 
-### V0: Mainnet
+### v0: Mainnet
 
 |                  | Details |
 |------------------|---------|

docs/cardano-network/_category_.json

@@ -1,4 +1,4 @@
 {
     "label": "FACT token",
-    "position": 3
+    "position": 6
   }

docs/developer-manual/_category_.json

@@ -0,0 +1,4 @@
+{
+    "label": "Incentivized Testnet (ITN)",
+    "position": 5
+  }

docs/developer-manual/deployments.md renamed to docs/developer-manual/orcfax-deployments.md

@@ -1,10 +1,10 @@
 ---
-id: overview
+id: ITN overview
 sidebar_position: 1
-slug: /overview
+slug: /itn-overview
 ---
 
-# Incentivized Testnet overview
+# ITN overview
 
 This section will be routinely updated and added to in order to keep our
 validators apprised of the most current information pertaining to the upcoming
@@ -36,8 +36,25 @@ strengthening the Mainnet protocol.
 
 To join the ITN, participants must meet the following:
 
+## Validator model introduction
+
+Orcfax validators are the software nodes run by a decentralized network of
+operators around the world. These Orcfax software nodes collect, validate,
+publish and archive real world data on-chain for Cardano decentralized apps
+(dApps) to use. Instead of having off-chain business deals and contracts with
+hand-picked validators, Orcfax is implementing a permissionless and
+decentralized Oracle pool model for its validator network.
+
+This means that anyone can become an Orcfax validator as long as they are able
+to meet the minimum [requirements](#technical-requirements).
+
 ### Validator license
 
+The Validator License is an NFT that represents the right to operate an Orcfax
+validator node. The NFT is non-redeemable, but tradable on the secondary
+markets. The use of a license and the required deposit is strategically designed
+to provide network security, clarity, and fairness within the Validator Network.
+
 Initially, participants may only be required to hold a validator license on a
 Mainnet wallet. However, as we progress through the more advanced phases of the
 ITN, participants will also need one on Testnet.
@@ -51,10 +68,23 @@ Testnet.
 
 ### 500,000 FACT deposit
 
+On March 1, 2024 The required $FACT deposit for node operation was set at
+500,000 $FACT. This sum was determined through market value, whereby either
+500,000 $FACT or 10,000 USD equivalent in $FACT on March 1st would be required
+(i.e. whichever $FACT amount is larger on that date).
+
 Participants need to maintain this balance in their Mainnet wallet, which will
 later need to be secured in a smart contract on the Testnet with tFACT
 (Testnet FACT).
 
+The Deposit is a redeemable amount of $FACT staked by validators for network
+participation. It ensures validator accountability and is subject to slashing
+(penalty) for actions that harm the oracle network (e.g. poor node network
+response time, contributing non-conformant data, etc). Validators will be able
+to reclaim their deposited $FACT anytime. However, removing the required stake
+amount will result in losing the ability to run their node until a deposit is
+added once again.
+
 ### Technical requirements
 
 The minimum hardware requirements for each phase will be published within their
@@ -92,6 +122,27 @@ for validator rewards. The first month will make 1,500,000 $FACT available for
 ITN participants to claim. This amount will be adjusted monthly to balance the
 rewards, based on the required effort and actual validator participation.
 
+#### Non-validator rewards
+
+All Orcfax $FACT holders were invited to vote on the first-ever Orcfax proposal:
+the implementation of rewards for $FACT holders. The proposal passed. More than
+28 million $FACT voted in favor of rewarding $FACT holders, and the results can
+be found [here][vote-1].
+
+Orcfax facilitated this community vote in alignment with our decentralization
+goals, and to allow opportunities for community members to participate in
+(and shape) the future of the Orcfax network.
+
+This proposal was requested by community members and introduced rewards for
+$FACT holders who may not have the capacity to join the Orcfax network as a
+validator, yet wish to receive $FACT rewards for locking (and not moving) their
+FACT tokens.
+
+Orcfax is investigating methods to implement non-validator staking for the
+initial version (V1) of the validator network.
+
+[vote-1]: https://app.summonplatform.io/poll/640336f9-0047-4055-91cf-4238ad4d182f
+
 ### Rewards calculation method
 
 Rewards will be calculated based on the daily number of collections,

docs/FACT token/_category_.json renamed to docs/fact-token/_category_.json

@@ -27,7 +27,7 @@ society at large.
 [cardano-1]: https://medium.com/coinmonks/why-cardano-in-2023-b481846028bc
 [smart-1]: oracle-basics#what-is-a-smart-contract
 
-## Getting Started
+## Getting started
 
 Check our developer manual for instructions on how to: