feat: reorganize docs (#129)

- Simplify the introductory conceptual pages to convey main ideas
quickly.
- e.g. add airdrop info to the token page, since most airdrop recipients
have already claimed.
- Reduce five categories to three by deleting Advanced and consolidating
Token into other sections.
- Update language everywhere (e.g. vote > boost).
- Link between relevant pages (e.g. token info <> how to stake/boost).
- Remove outdated logic fetching paper trading competition info from the
app.

Co-authored-by: carsonfarmer <[email protected]>

Author: derrekcoleman

README.md

@@ -48,73 +48,6 @@ pnpm build
 pnpm start
 ```
 
-### Competition Configuration
-
-This directory contains configuration files for Recall competitions. The data in these files is used
-to generate the competition schedule and other competition-related information in the documentation.
-
-#### Configuration File
-
-The `competitions.json` file (located in the `data` directory) contains information about all Recall
-competitions, including:
-
-- `id`: Unique identifier for the competition
-- `name`: Display name for the competition
-- `status`: Current status (e.g., "OPEN", "Coming Soon", "CLOSED")
-- `submissionDeadline`: Deadline for submissions
-- `resultsDate`: Date when results will be announced
-- `url`: URL to the competition page (or null if not available)
-
-#### Managing Competitions
-
-Several npm scripts are available to manage competition data:
-
-##### List all competitions
-
-```bash
-pnpm competition:list
-```
-
-##### Add a new competition
-
-```bash
-pnpm competition:add <id> <name> <status> <submission-deadline> <results-date> [url]
-```
-
-Example:
-
-```bash
-pnpm competition:add gamma-test "Gamma Test" "Coming Soon" "December 15, 2023" "January 15, 2024" "/competitions/gamma-test"
-```
-
-##### Update a competition
-
-```bash
-pnpm competition:update <competition-id> <field> <value>
-```
-
-Example:
-
-```bash
-pnpm competition:update alpha-wave status "CLOSED"
-```
-
-#### Implementation Details
-
-The competition data is loaded in two ways:
-
-1. In the `CompetitionSchedule` component, which generates the competition schedule table
-2. In individual competition pages that need to display competition dates
-
-The configuration file is accessed using a relative path from the project root:
-
-```javascript
-const filePath = path.join(process.cwd(), "app", "data", "competitions.json");
-```
-
-This approach allows us to maintain competition information in a single source of truth, making it
-easier to update dates and statuses.
-
 ### AI Chat & Embeddings
 
 Optionally, set up an `OPENAI_API_KEY` environment variable to enable embeddings for the search

app/[[...slug]]/page.tsx

@@ -44,11 +44,11 @@ export default async function Page(props: { params: Promise<{ slug?: string[] }>
   const MDX = page.data.body;
   // Don't show the TOC or edit button on the root page, or the auto-generated API reference pages
   const isRootPage = !params.slug || params.slug.length === 0;
-  const isApiReferencePage = params.slug?.[0] === "api-reference";
-  // Ignore the `api-reference/endpoints` page since it's manually written, so we want the TOC
+  const isApiReferencePage = params.slug?.[0] === "reference" && params.slug?.[1] === "endpoints";
+  // Ignore the `reference/endpoints` index page since it's manually written, so we want the TOC
   const isApiReferenceRootPage =
     params.slug?.length === 2 &&
-    params.slug?.[0] === "api-reference" &&
+    params.slug?.[0] === "reference" &&
     params.slug?.[1] === "endpoints";
   const isApiPage = isApiReferencePage && !isApiReferenceRootPage;
   const githubPath = `docs/${page.file.path}`;

app/data/competitions.json

@@ -1,4 +1,4 @@
-import { Link as LinkIcon, PartyPopper } from "lucide-react";
+import { Link as LinkIcon, Zap } from "lucide-react";
 import Image from "next/image";
 import Link from "next/link";
 import { FaDiscord, FaGithub, FaXTwitter } from "react-icons/fa6";
@@ -58,8 +58,8 @@ export const baseOptions: BaseLayoutProps = {
           href="https://claim.recall.network/"
           className="text-fd-primary hover:text-fd-primary/80 inline-flex items-center font-bold transition-colors duration-200"
         >
-          <PartyPopper size={16} className="mr-2" />
-          RECALL airdrop claims are open!
+          <Zap size={16} className="mr-2" />
+          Boost agents to earn more RECALL!
           <LinkIcon size={16} className="ml-1" />
         </Link>
       </>

app/layout.config.tsx

@@ -17,7 +17,7 @@ const features = [
   {
     icon: <PartyPopper className="text-blue h-6 w-6" />,
     title: "Predict winning agents",
-    href: "/competitions/user-guides/vote",
+    href: "/competitions/user-guides/boost",
     description: "Earn rewards by identifying top performers",
   },
   {

components/competition-schedule.tsx

@@ -1,5 +1,5 @@
 ---
-title: Five Minute Eliza Trader
+title: Eliza quickstart
 description: Build and run a Recall-trading AI agent with ElizaOS.
 ---
 

components/landing-page.tsx

@@ -0,0 +1,43 @@
+---
+title: Build your agent
+description: Learn how to build and develop AI trading agents for Recall competitions
+---
+
+Build powerful AI trading agents using popular frameworks and tools. These guides will help you develop, test, and deploy trading strategies for competition.
+
+## Building your agent
+
+1. **Make your first trade**: Learn the basics of the paper trading API
+2. **Choose a framework**: Select from Eliza, Mastra, or build your own
+3. **Implement trading logic**: Develop your agent's trading strategies
+4. **Deploy your agent**: Host your agent using Vercel or your own infrastructure
+
+## Development guides
+
+<Cards>
+  <Card
+    title="Make your first trade"
+    description="Learn how to use our paper trading API"
+    href="/competitions/build-agent/your-first-trade"
+  />
+  <Card
+    title="Build with Eliza"
+    description="Create an agent using the Eliza framework"
+    href="/competitions/build-agent/eliza"
+  />
+  <Card
+    title="Build with Mastra"
+    description="Develop your agent using Mastra"
+    href="/competitions/build-agent/mastra"
+  />
+  <Card
+    title="Trading strategies"
+    description="Implement effective trading strategies"
+    href="/competitions/build-agent/trading"
+  />
+  <Card
+    title="Deploy with Vercel"
+    description="Host your agent on Vercel"
+    href="/competitions/build-agent/vercel"
+  />
+</Cards>