Docs content fixes and tooling cleanup

.github/workflows/firebase-live.yml

@@ -24,7 +24,7 @@ jobs:
       - name: Build Docs
         env:
           NODE_OPTIONS: "--max_old_space_size=4096"
-        run: npm run docs:build
+        run: pnpm docs:build
 
       - uses: FirebaseExtended/action-hosting-deploy@v0
         with:

.github/workflows/firebase-preview.yml

@@ -1,8 +1,6 @@
 name: Deploy Preview to Firebase Hosting
 on:
   pull_request:
-    branches-ignore:
-      - live-site
 
 jobs:
   build_and_preview:
@@ -24,7 +22,7 @@ jobs:
       - name: Build Docs
         env:
           NODE_OPTIONS: "--max_old_space_size=4096"
-        run: npm run docs:build
+        run: pnpm docs:build
 
       - uses: FirebaseExtended/action-hosting-deploy@v0
         with:

.github/workflows/main.yml

@@ -29,9 +29,6 @@ jobs:
       - name: Lint
         run: pnpm lint
 
-      - name: Test
-        run: pnpm test
-
       - name: Build documentation
         run: pnpm docs:build
 

.gitignore

@@ -1,4 +1,3 @@
-/.DS_Store/
 .DS_Store
 .idea/
 .vscode/
@@ -12,19 +11,5 @@ docs/.vitepress/.temp
 docs/public/llms.txt
 docs/public/llms-full.txt
 
-/indexes/content-files/
-
-yarn-error.log
 package-lock.json
 firebase-debug.log
-libs/myGitHubToken.json
-
-
-# Ignoring a Previously Committed Files #
-# The files in your working copy can be either tracked or untracked.
-# To ignore a file that has been previously committed, you’ll need to 
-# unstage and remove the file from the index, and then add a rule for the file in .gitignore:
-# git rm --cached filename
-# The --cached option tells git not to delete the file from the working tree 
-# but only to remove it from the index.
-# To recursively remove a directory, use the -r option:

.prettierignore

@@ -2,25 +2,11 @@
 /.github
 /.vscode
 /node_modules
-/archives
 pnpm-lock.yaml
 
-# .vitepress
 /docs/.vitepress/cache
 /docs/.vitepress/dist
-/docs/.vitepress/public
-/docs/.vuepress/styles
-
 /docs/public/img
-/docs/public/api3-whitepaper-v1.0.3.pdf
 
 docs/public/llms.txt
 docs/public/llms-full.txt
-
-# assets
-/docs/reference/ois/latest/assets
-/docs/reference/airnode/latest/assets
-/docs/reference/dao-members/assets
-/docs/reference/chainapi/assets
-/docs/reference/qrng/assets
-/docs/oev/assets

README.md

@@ -2,7 +2,7 @@
 
 > Source of the API3 documentation published at https://docs.api3.org
 
-The site is built with [VitePress](https://vitepress.dev/). Content lives under [`docs/`](./docs), one directory per top-level section. Each section owns its `sidebar.js` and is registered in [`docs/.vitepress/config.js`](./docs/.vitepress/config.js) and in [`scripts/generate-llms-files.js`](./scripts/generate-llms-files.js). The landing page is [`docs/index.md`](./docs/index.md).
+The site is built with [VitePress](https://vitepress.dev/). Content lives under [`docs/`](./docs), one directory per top-level section. Each section owns its `sidebar.js` and is registered in [`docs/.vitepress/config.js`](./docs/.vitepress/config.js), which the llms generator reads too. The landing page is [`docs/index.md`](./docs/index.md).
 
 ## Development
 

docs/.vitepress/config.js

@@ -1,6 +1,6 @@
-export default {
-  title: 'Api3 documentation',
-  description: 'Api3 documentation',
+module.exports = {
+  title: 'API3 documentation',
+  description: 'API3 documentation',
   markdown: {
     lineNumbers: true,
     toc: ['h2', 'h3', 'h4', 'h5'],

docs/.vitepress/theme/index.js

@@ -3,8 +3,6 @@ import { onMounted, watch, nextTick } from 'vue';
 import { useRoute } from 'vitepress';
 import mediumZoom from 'medium-zoom';
 import PageHeader from '../../_components/PageHeader.vue';
-import CopyIcon from '../../_components/CopyIcon.vue';
-import Video from '../../_components/Video.vue';
 
 import './zoom.css';
 
@@ -26,7 +24,5 @@ export default {
 
   enhanceApp({ app }) {
     app.component('PageHeader', PageHeader);
-    app.component('CopyIcon', CopyIcon);
-    app.component('Video', Video);
   },
 };

docs/curation/disclosure.md

@@ -8,68 +8,68 @@ outline: deep
 
 # Disclosure
 
-This page describes the scope of Api3's role as a Morpho vault curator, the risks involved in interacting with Api3-curated vaults, and the limits of Api3's responsibility and ability.
-By depositing into, withdrawing from, or otherwise interacting with any vault curated by Api3, you acknowledge and accept the Api3 [terms and conditions,](https://api3.org/terms-and-conditions/) which apply to all services and software provided by the API3 Foundation ("Api3"), as well as the additional supplemental disclosures in these docs.
+This page describes the scope of API3's role as a Morpho vault curator, the risks involved in interacting with API3-curated vaults, and the limits of API3's responsibility and ability.
+By depositing into, withdrawing from, or otherwise interacting with any vault curated by API3, you acknowledge and accept the API3 [terms and conditions,](https://api3.org/terms-and-conditions/) which apply to all services and software provided by the API3 Foundation ("API3"), as well as the additional supplemental disclosures in these docs.
 
 ## Scope of curation
 
-Api3's role as a curator is limited to setting on-chain vault parameters within the [Morpho Protocol](https://morpho.org/) — selecting enabled markets, configuring supply caps, assigning roles, and operating the automation described elsewhere in these docs.
+API3's role as a curator is limited to setting on-chain vault parameters within the [Morpho Protocol](https://morpho.org/) - selecting enabled markets, configuring supply caps, assigning roles, and operating the automation described elsewhere in these docs.
 
-Api3 does not hold, control, or take custody of any user assets.
+API3 does not hold, control, or take custody of any user assets.
 All deposits, withdrawals, and market interactions occur directly through Morpho's open-source, non-custodial smart contracts.
 Users remain solely responsible for the custody and security of their private keys and digital assets.
 
-Interactions with Morpho's smart contracts, interfaces, and other services are governed by Morpho's own [terms](https://morpho.org/terms-of-use/) and documentation. Api3 has no responsibility for nor ability to affect the Morpho Protocol services, smart contracts, nor its operation or maintenance.
+Interactions with Morpho's smart contracts, interfaces, and other services are governed by Morpho's own [terms](https://morpho.org/terms-of-use/) and documentation. API3 has no responsibility for nor ability to affect the Morpho Protocol services, smart contracts, nor its operation or maintenance.
 
 ## No offer, no advice
 
-Nothing in this documentation, nor any parameters, strategies, or materials related to Api3-curated vaults, constitutes:
+Nothing in this documentation, nor any parameters, strategies, or materials related to API3-curated vaults, constitutes:
 
 - An offer to sell or solicitation to buy any financial instrument, investment product, or security.
 - Financial, investment, legal, tax, accounting, or other professional advice.
 - A recommendation to take or refrain from taking any action.
 
-Api3 does not act as your broker, investment adviser, fiduciary, or asset manager. All information is provided for general informational purposes only, and users are expected to conduct their own due diligence before interacting with any vault, including the verification of any transaction settings and parameters whether or not shown or suggested by any Api3 service or site.
+API3 does not act as your broker, investment adviser, fiduciary, or asset manager. All information is provided for general informational purposes only, and users are expected to conduct their own due diligence before interacting with any vault, including the verification of any transaction settings and parameters whether or not shown or suggested by any API3 service or site.
 
 ## Risks
 
-Interacting with Api3-curated vaults involves significant risks. These include, but are not limited to:
+Interacting with API3-curated vaults involves significant risks. These include, but are not limited to:
 
-- **Market risk** — Collateral assets may experience extreme volatility or illiquidity, leading to bad debt in the underlying lending markets that cannot be fully liquidated.
-- **Smart contract risk** — Vulnerabilities or bugs in the Morpho Protocol, the collateral tokens, the oracle infrastructure, or any other contract in the stack may result in partial or total loss of funds.
-- **Oracle risk** — Although Api3 operates as the oracle provider for its own markets, oracle systems can fail, be manipulated, or behave unexpectedly during adverse market conditions.
-- **Parameter and governance risk** — Market configurations, supply caps, role assignments, and other parameters may be changed. Changes that increase risk to depositors, such as adding markets or raising supply caps, are subject to a timelock to ensure users have enough time to review the changes.
-- **Liquidity risk** — Under stressed market conditions, withdrawals may be temporarily delayed pending the availability of idle liquidity or successful rebalancing across markets.
-- **Regulatory risk** — Legal and regulatory treatment of vaults, tokenized positions, and DeFi lending may change in ways that adversely affect users.
+- **Market risk** - Collateral assets may experience extreme volatility or illiquidity, leading to bad debt in the underlying lending markets that cannot be fully liquidated.
+- **Smart contract risk** - Vulnerabilities or bugs in the Morpho Protocol, the collateral tokens, the oracle infrastructure, or any other contract in the stack may result in partial or total loss of funds.
+- **Oracle risk** - Although API3 operates as the oracle provider for its own markets, oracle systems can fail, be manipulated, or behave unexpectedly during adverse market conditions.
+- **Parameter and governance risk** - Market configurations, supply caps, role assignments, and other parameters may be changed. Changes that increase risk to depositors, such as adding markets or raising supply caps, are subject to a timelock to ensure users have enough time to review the changes.
+- **Liquidity risk** - Under stressed market conditions, withdrawals may be temporarily delayed pending the availability of idle liquidity or successful rebalancing across markets.
+- **Regulatory risk** - Legal and regulatory treatment of vaults, tokenized positions, and DeFi lending may change in ways that adversely affect users.
 
-Past performance does not guarantee future results. Vault strategies may be changed, expanded, or discontinued at any time, and parameter changes are at Api3's sole discretion.
+Past performance does not guarantee future results. Vault strategies may be changed, expanded, or discontinued at any time, and parameter changes are at API3's sole discretion.
 
 ## No guarantees
 
-Api3's curation services are provided on an "as is" basis, without warranties of any kind, whether express or implied.
-Api3 makes no representation or guarantee as to:
+API3's curation services are provided on an "as is" basis, without warranties of any kind, whether express or implied.
+API3 makes no representation or guarantee as to:
 
 - The safety of assets deposited into any vault.
 - The accuracy or appropriateness of any parameter or risk classification.
 - The future yield or performance of any strategy.
 - The availability of withdrawal liquidity at any given time.
 
-The fact that Api3 deploys a portion of its own treasury into the vaults it curates (as described under [Skin in the game](/curation/#skin-in-the-game)) reflects alignment of incentives, but is not a guarantee, backstop, or commitment to compensate third-party depositors for any loss.
+The fact that API3 deploys a portion of its own treasury into the vaults it curates (as described under [Skin in the game](/curation/#skin-in-the-game)) reflects alignment of incentives, but is not a guarantee, backstop, or commitment to compensate third-party depositors for any loss.
 
 ## Restricted access
 
-To Api3's knowledge, Morpho's vaults (whether or not Api3-curated) are not registered with, or approved by, any financial regulatory authority in any jurisdiction.
-They are not available to, and must not be accessed by, persons or entities located, incorporated, or resident in jurisdictions where such access is restricted or prohibited — including, without limitation, jurisdictions subject to comprehensive sanctions administered by the UN, OFAC or other competent authorities.
+To API3's knowledge, Morpho's vaults (whether or not API3-curated) are not registered with, or approved by, any financial regulatory authority in any jurisdiction.
+They are not available to, and must not be accessed by, persons or entities located, incorporated, or resident in jurisdictions where such access is restricted or prohibited - including, without limitation, jurisdictions subject to comprehensive sanctions administered by the UN, OFAC or other competent authorities.
 
-By interacting with an Api3-curated vault, you represent that you are not a prohibited person and that you are acting in full compliance with Api3's terms and all laws applicable to you.
+By interacting with an API3-curated vault, you represent that you are not a prohibited person and that you are acting in full compliance with API3's terms and all laws applicable to you.
 
 ## Limitation of liability
 
-Api3's role is limited to setting vault parameters within the Morpho Protocol. Api3 has no contractual relationship with vault users and assumes no liability nor responsibility for any losses, damages, or claims arising out of or in connection with the use of any vault nor any of the Risks enumerated above, including but not limited to those caused by:
+API3's role is limited to setting vault parameters within the Morpho Protocol. API3 has no contractual relationship with vault users and assumes no liability nor responsibility for any losses, damages, or claims arising out of or in connection with the use of any vault nor any of the Risks enumerated above, including but not limited to those caused by:
 
 - Smart contract failures, exploits, or forks of the underlying protocols.
 - Failures or inaccuracies of any third-party data source, valuation, or price feed.
 - User error, loss of private keys, or compromised wallets.
 - Regulatory actions, changes in law, or force majeure events (including cyberattacks and network failures).
 
-To the maximum extent permitted by law, Api3 shall not be liable for any direct, indirect, incidental, special, consequential, or punitive damages arising from your use of any Api3-curated vault or other service. In the event of any conflict between these disclosures and the Api3 [terms and conditions](https://api3.org/terms-and-conditions/), the Api3 terms and conditions shall control.
+To the maximum extent permitted by law, API3 shall not be liable for any direct, indirect, incidental, special, consequential, or punitive damages arising from your use of any API3-curated vault or other service. In the event of any conflict between these disclosures and the API3 [terms and conditions](https://api3.org/terms-and-conditions/), the API3 terms and conditions shall control.