review of docs against editorialGuide

Author: Christian-MK

docs/FACT token/economic-model.md

@@ -7,19 +7,19 @@ slug: /economic-model
 # Economic Model
 
 The FACT token lies at the core of Orcfax's economic model. To access Orcfax
-feeds, consumers (e.g. dApps, smart contracts) must use $FACT for payment. While
+feeds, consumers (e.g. dApps, smart contracts) can use $FACT for payment. While
 consumers can also use ADA, these payments are exchanged for FACT tokens,
 creating a positive feedback loop that boosts demand for the FACT token.
 
 Since consumers pay for on-chain publications, an increase in consumers leads to
 more publications, driving up the demand for the FACT token. The generated $FACT
 payments are distributed to entities crucial for network operation and security:
-Orcfax Validators and the Orcfax network.
+Orcfax Validators and the Orcfax Network.
 
 ![Orcfax Economic Model](/img/2024-02--Orcfax-economic-model2.jpg)
 
 Initially, with a relatively low number of consumers and publications after the
-decentralized network launches on mainnet, validators and the Orcfax network
+decentralized network launches on mainnet, validators and the Orcfax Network
 will receive compensation through the
 '[Validator Rewards Allocation][rewards-1]'. This allocation, constituting 50%
 of the total FACT token supply, rewards Validators and the Orcfax Network. The
@@ -29,7 +29,7 @@ payments from these customers will compensate for the reduced emission from the
 Validator Rewards Allocation, and will eventually replace them completely.
 
 Though other FACT holders aren't involved in operating and securing the initial
-version of the validator network (V1), [the community has decided][vote-1] to
+version of the validator Network (V1), the community has [decided][vote-1] to
 allocate a small portion of FACT rewards to be used as rewards for FACT holders
 willing to lock their tokens. The estimated APY for doing this is 3-8%. These
 rewards will partly come from the Validator Rewards Allocation and partly from

docs/FACT token/tokenomics.md

@@ -4,22 +4,22 @@ sidebar_position: 1
 slug: /tokenomics
 ---
 
-# FACT Tokenomics
+# FACT tokenomics
 
 The FACT [utility token](utility-token) has a fixed supply of 1 billion tokens.
 
 The FACT token minting policy ID is
 [a3931691f5c4e65d01c429e473d0dd24c51afdb6daf88e632a6c1e51][policyid-1].
 
-The FACT token is tradeable on [Cardano DEX markets][dexes-1]. It is listed on
+The FACT token is tradeable on [Cardano DEX markets][dex-1]. It is listed on
 coin tracking sites like [CoinGecko][listing-1] and [CoinMarketCap][listing-2].
 
 [policyid-1]: https://pool.pm/asset1kuwfd0esf9xcxurp2x4f9w65lvz4tkfw5epugq
 [listing-1]: https://www.coingecko.com/en/coins/orcfax
 [listing-2]: https://coinmarketcap.com/currencies/orcfax/
-[dexes-1]: https://www.taptools.io/charts/token?pairID=026a18d04a0c642759bb3d83b12e3344894e5c1c7b2aeb1a2113a570.2b4e632bf755fe5e33309a47216aa396106641edd056423e2ef2a08ce30bb604
+[dex-1]: https://www.taptools.io/charts/token?pairID=026a18d04a0c642759bb3d83b12e3344894e5c1c7b2aeb1a2113a570.2b4e632bf755fe5e33309a47216aa396106641edd056423e2ef2a08ce30bb604
 
-## Token Distribution
+## Token distribution
 
 Following the token generation event (TGE), the Orcfax team distributed all
 1,000,000,000 $FACT to a series of [ADA Handle][handle-1] wallets. Each of these
@@ -55,16 +55,16 @@ The biggest allocation is reserved to reward our decentralized validators for
 running Orcfax nodes.
 
 500,000,000 (50%) $FACT have been allocated for rewarding Orcfax validator node
-operators for collecting, formatting, validating, publishing and archiving
+operators for collecting, normalizing, validating, publishing and archiving
 real-world data for consumption as eUTXO datum by Cardano dApps and smart
 contracts.
 
 This allocation is meant to subsidize operations long enough for the network to
 become self-sustaining based on fee collection. This allocation is a serious
-signal that Orcfax understands a healthy, thriving validator pool network is
-required for the long-term viability and value of the network.
+signal that Orcfax understands that a healthy validator network is required for
+the long-term viability and value of the network.
 
-This allocation has a cliff date or vesting schedule. However, How it is paid
+This allocation does not have a cliff date or vesting schedule. How it is paid
 out to validators will be made public after the close of the Orcfax Incentivized
 Testnet.
 
@@ -76,14 +76,14 @@ way of $FACT airdrops and giveaways. The project will also leverage this
 allocation in various public relations campaigns going forward.
 
 This allocation has a cliff date of 3 months after the start of the ISPO and a 6
-month vesting period.
+month vesting period (i.e. after 3 months, distributed monthly for 6 months).
 
 ## Team
 
 150,000,000 (15%) $FACT have been allocated for disbursement among the founding
 team; this allocation will be distributed to the founder and team members in
-order to compensate for their significant investments, both in time and effort
-to launch the Orcfax network.
+order to compensate them for their significant investments, both in time and
+effort to launch the Orcfax Network.
 
 This allocation has a cliff date of 3 months after the start of the ISPO and a
 24 month vesting period.
@@ -165,16 +165,15 @@ $FACT by delegating ADA to our ISPO pool.
 
 The cliff date for the first ISPO drops was September 2023, with 10% of the
 total $FACT supply allocated to ISPO participants. This allocation had a cliff
-date of 6 months after the start of the ISPO and a 6 month vesting period (i.e.
-distributed monthly, for 6 months).
+date of 6 months after the start of the ISPO and a 6 month vesting period.
 
 [ispo-1]: https://orcfax.io/assets/Orcfax-ISPO-Prospectus--March15-2023.pdf
 [ispo-2]: https://docs.orcfax.io/assets/files/2023-07-07--Orcfax-ISPO-reflection-0212f8cd59e995f75fc8d5c0ad2625e7.pdf
 
 ## Yield Farming APY
 
-20,000,000 (2%) FACT tokens are used to enhance the appeal of our liquidity
-pool(s) by offering substantial Yield Farming Rewards to our liquidity
+20,000,000 (2%) FACT tokens were used to enhance the appeal of our liquidity
+pool(s) by offering substantial yield farming rewards to our liquidity
 providers.
 
 Yield farming, also called liquidity mining, involves lending or staking
@@ -184,12 +183,13 @@ like WingRiders, or Minswap. In return, users receive (native) tokens or other
 fees as rewards. Rewards vary based on factors like asset type, amount,
 duration, and platform demand.
 
-These tokens received by users as a reward have no cliff and/or vesting
-restrictions.
+The tokens received by users as a reward for their staked $FACT have no cliff
+and/or vesting restrictions.
 
 ### Disclaimer
 
-The information provided above is for educational and informational
-purposes only. Yield farming involves financial risks, and individuals should
-carefully consider their own financial situation, risk tolerance, and investment
-goals before participating in any yield farming program.
+Orcfax does not offer financial advice. The information provided above is for
+educational and informational purposes only. Yield farming involves financial
+risks, and individuals should carefully consider their own financial situation,
+risk tolerance, and investment goals before participating in any yield farming
+program.

docs/FACT token/utility-token.md

@@ -1,10 +1,10 @@
 ---
-id: faq-1
+id: utility-token
 sidebar_position: 3
 slug: /utility-token
 ---
 
-# FACT utility
+# The FACT utility token
 
 The Orcfax platform includes a Cardano-native utility token which has been named
 $FACT. This utility token has been designed with a limited number of explicit
@@ -13,7 +13,7 @@ uses. $FACT can be  used for:
 1. Payment by consumers for data publication, either by a heartbeat publication
 model or an on-demand publication model
 2. Staking by our data validator nodes to participate in oracle processes
-3. Reward payments to validators for participation in the Orcfax node network
+3. Reward payments to validators for participation in the Orcfax Network
 4. Voting power in Orcfax DAO governance decisions
 
 Importantly, Orcfax has grounded the utility of the token by minting a fixed
@@ -26,15 +26,15 @@ More information about the utility of the FACT token can be found in thr Orcfax
 
 ## Utility 1: Payment
 
-The FACT token is used in the Orcfax network as the form of payment for the fees
-charged to publish new fact statements.
+The FACT token is used in the Orcfax Network as the form of payment for the fees
+charged to publish new Fact Statements.
 
 Orcfax feed consumers (e.g. dApp, smart contract) seeking to fund feeds which
 are published on a user-stipulated heartbeat schedule will have the cost of
 publication quoted in FACT.
 
 Alternatively, if an Orcfax feed consumer needs a more current update for a
-given datum feed (e.g. ADA/USD) than is available on-chain, then an on-demand
+given datum feed (e.g. ADA-USD) than is available on-chain, then an on-demand
 publication request can be triggered. The cost of publishing this new fact datum
 on-chain will likewise be quoted in $FACT.
 
@@ -48,41 +48,39 @@ creating a positive feedback loop that boosts demand for the FACT token.
 $FACT will also be used by Orcfax validator node operators as staked collateral
 to incentivize good performance and trust in the network.
 
+On January 9th, 2024 Orcfax published its
+[Orcfax Validator License Announcement][announce-1], which outlined what
+potential node operators, and non-validators, could look forward to as licenses
+became available and as the Incentivized Testnet (ITN) is being developed.
+
 To become an Orcfax Validator, users are required to 1) mint and/or hold a
 Validator license, and 2) deposit $FACT tokens into the Orcfax validator smart
 contract.
 
 1. There are only 100 validator licenses available for node operation. During
 the origin minting process, each license cost 100,000 $FACT.
-2. The required $FACT deposit will be determined by market value as of 1 March
-2024, whereby either 500,000 $FACT or 10,000 USD equivalent in $FACT will be
-required (i.e. whichever $FACT amount is larger on that date).
+2. When the validator nodes begin operating, a deposit of 500,000 $FACT will be
+required in the validator smart contract.
 
 By requiring operators to put up a certain amount of $FACT to run a node,
 operators demonstrate their “skin in the game”. Orcfax decided on the required
 amount of $FACT which simultaneously encourages a diverse community of node
-operators while also discouraging bad actors.
-
-On January 9th, 2024 Orcfax announced published its
-[Orcfax Validator License Announcement][announce-1], which outlined what
-potential node operators and non-validators could look forward to as licenses
-became available and as the incentivized testnet (ITN) was rolled out.
-
-If, for whatever reason, a node reports irregular data or has persistent
-networking issues, then their deposited stake will be slashed by the protocol.
-This is both a penalty for jeopardizing the integrity of the Orcfax network, as
-well as an incentive to re-calibrate their node operations.
+operators while also discouraging bad actors. If, for whatever reason, a node
+reports irregular data or has persistent networking issues, then their deposited
+stake may be slashed by the protocol. This is both a penalty for jeopardizing
+the integrity of the Orcfax Network, as well as an incentive to diligently
+monitor and re-calibrate node operation as appropriate.
 
 [announce-1]: https://medium.com/@orcfax/orcfax-validator-license-announcement-5da07ef1439c
 
 ## Utility 3: Rewards
 
-When a fact statement is published on chain the validator that was randomly
+When a Fact is published on chain, the validator which was randomly
 selected to put that statement on-chain will be rewarded with FACT tokens. This
 means that because the amount of Validator licenses are limited, more feeds
-means more rewards will be distributed to each active validator.
+will result in more rewards being distributed to each active validator.
 
-The initial version of the validator network (V1) will be designed to select
+The initial version of the Validator Network (v1) will be designed to select
 validators at random to publish a fact statement, giving all validators an equal
 chance of earning a reward. Future models will weight this random distribution
 by biasing rewards to those with higher $FACT delegation.
@@ -98,18 +96,18 @@ Validators have the ability to estimate potential rewards that they can expect
 by utilizing the [initial rewards calculator][calc-1].
 
 The calculator allows users to simulate certain scenarios by modifying the most
-important parameters that define the estimated rewards (like number of feeds).
+important parameters that define the estimated rewards (e.g. number of feeds).
 The yellow fields can be modified by the user. Some fields include notes to help
 users understand how the calculation works.
 
 [calc-1]: https://docs.google.com/spreadsheets/d/1aH4Zwtn8KUTtrdzBBZFK1_Kulb7_a4uJGjzLhmPTLFc/edit#gid=1934045699
 
 ## Utility 4: Voting
 
-Governance of the Orcfax network, including its technical operations, R&D,
+Governance of the Orcfax Network, including its technical operations, R&D,
 community management, new feed nominations, fee schedule, etc., will all be
-transitioned from Orcfax Ltd. to a Decentralized Autonomous Organization after
-the network has proven to be healthy and self-sustaining.
+transitioned from Orcfax Ltd. to a Decentralized Autonomous Organization (DAO)
+after the network has proven to be healthy and self-sustaining.
 
 As different proposals are brought to the Orcfax DAO for approval, the FACT
 token will serve as stake in weighted voting scores. That is to say, the more

docs/FAQ/faq-1.md

@@ -6,12 +6,12 @@ slug: /oracle-basics
 
 # Oracle basics
 
-## What is an oracle?
+## What is a blockchain oracle?
 
-Oracles like [Orcfax](https://orcfax.io/), [Chainlink](https://chain.link),
-[Charli3](https://charli3.io), etc. are the technical component in blockchain
-architectures that deliver data about the real-world to on-chain smart
-contracts.
+Blockchain oracles such as [Orcfax][oracle-1], [Chainlink][oracle-2],
+[Charli3][oracle-3], etc. are the technical component in blockchain
+architectures which bring data about the real world on-chain for consumption by
+smart contracts.
 
 The name is derived from people in the ancient world who delivered messages and
 knowledge from the gods to the mortals.
@@ -20,26 +20,30 @@ knowledge from the gods to the mortals.
 
 Software oracles process information from online sources such as website
 content and open datasets but mostly from server-based application programming
-interfaces (API). These are the most common types of oracles and are used, for
-example, by algorithmic stablecoins or automated market maker (AMM) exchanges
-to monitor for changes in currency exchange rates.
+interfaces (API). These are the most common types of oracles and are used by
+algorithmic stablecoins or automated market maker (AMM) exchanges to monitor for
+changes in currency exchange rates.
 
 See [this article](https://cointelegraph.com/learn/what-is-a-blockchain-oracle-and-how-does-it-work)
 for some further information about oracles and their role in blockchain networks
 .
 
+[oracle-1]: https://orcfax.io/
+[oracle-2]: https://chain.link
+[oracle-3]: https://charli3.io
+
 ## What is a smart contract?
 
 Smart contracts are software programs that execute conditional logic on
-next-generation blockchains like Cardano  (e.g. when event X happens, trigger
-action Y).  Because their source code is immutably stored and run on
+next-generation blockchains like Cardano (e.g. when event X happens, trigger
+action Y). Because their source code is immutably stored and run on
 decentralized blockchain networks, they constrain the range of permissible user
 actions and their effects.
 
 This means that they can reasonably be expected to have the same outcome each
-time they are triggered. Therefore smart contracts are often referred to as
-having "trustless" qualities. The term "trustless" is a popular word to
-characterize blockchain technology because its cryptographic proofs and
+time they are triggered. It is for this reason that smart contracts are often
+referred to as having "trustless" qualities. The term "trustless" is a popular
+word to characterize blockchain technology because its cryptographic proofs and
 distributed consensus algorithms ensure that its shared data is authentic,
 accurate, and secure without reliance on a trusted third-party to verify the
 information.
@@ -55,24 +59,24 @@ because the execution of smart contract logic can have significant economic
 and social consequences. Especially considering that the consequences of a
 blockchain transaction are irreversible by their very design.
 
-For example:
-
-* A change in the Bitcoin to ADA price may trigger a limit order in a DeFi
-smart contract.
-* The final score in a sports event may trigger a payout in a betting dApp
-smart contract.
-* An extreme weather event may trigger a payout for a crop insurance smart
-contract.
-* The words spoken in a political speech and authenticated via blockchain
-notarization may trigger policy changes or protests.
+>Example:
+>
+>* A change in the Bitcoin to ADA price may trigger a limit order in a DeFi
+>smart contract.
+>* The final score in a sports event may trigger a payout in a betting dApp
+>smart contract.
+>* An extreme weather event may trigger a payout for a crop insurance smart
+>contract.
+>* The words spoken in a political speech and authenticated via blockchain
+>notarization may trigger policy changes.
 
 ## What is the oracle problem?
 
-The blockchain industry refers to the "oracle problem" to refer to the various
+The blockchain industry uses the "oracle problem" to refer to the various
 issues related to ensuring that on-chain smart contracts can trust real world
 data inputs to be authentic and accurate.
 
-The trillion dollar DeFi industry is critically dependent on real-world data
+The DeFi industry is critically dependent on real-world data
 provided by oracles. However, oracle engineering is still in an early stage.
 There are still many opportunities to introduce false data about real-world
 events into oracle data collection, validation and publication pipelines.
@@ -85,7 +89,7 @@ to smart contracts can be trusted to be authentic and accurate.
 
 Most oracle providers provide little to no traceability on how their
 published, on-chain data is collected and validated to be authentic and
-accurate. Their users simply see a single magic data point appear on chain. The
+accurate. Their users simply see a data point appear on chain. The
 context of creation and use is provided by the on-chain transaction, not the
 oracle datum itself.
 
@@ -100,9 +104,9 @@ often receive data from a single, black box provider. They then might use an
 oracle pool to arrive at a consensus about the *uniformity* of that data and
 not necessarily about its *authenticity* or *accuracy*.
 
-Orcfax was intentionally designed as a
-[second-generation oracle](solution-overview) service that addresses multiple
-layers of the oracle problem in a more comprehensive way.
+Orcfax has been, and continues to be, intentionally designed to addresses
+the multiple layers of the oracle problem and to do so in a more comprehensive
+way than eny other oracle service.
 
 ## What is the real world?
 
@@ -124,13 +128,13 @@ A fact is something that is known to have happened or to exist, especially
 something for which proof exists, or about which there is information.
 (Cambridge Dictionary, 2021)
 
-Truths can be interpretive, opinionated, exclusionary, contextual or personal,
-e.g. "this cylinder makes pretty shadows that are blue and circular".
+Truths can be interpretive, opinionated, exclusionary, contextual or personal
+(e.g. "this cylinder makes pretty shadows that are blue and circular").
 
 ![Facts lead to truths](/img/2023-09-05--Orcfax--The-Nature-Of-Facts.png)
 
-Fact statements are more definitive, e.g.
-"the name of this image file is what-is-true.png". Orcfax publishes fact
-statements about the real world to the Cardano blockchain.
+Fact statements are more definitive
+(e.g."the name of this image file is what-is-true.png"). Orcfax publishes Fact
+Statements about the real world to the Cardano blockchain.
 
 ![The nature of facts](/img/2023-09-06--Orcfax--Nature-of-Facts.png)