Restructure docs for ICO/token sale focus

[dennisonbertram]

Summary

This PR restructures the Tally documentation to prioritize token sales and ICO content, following a user-journey-focused model similar to MetaDAO's documentation.

New Structure (7 sections, ~25 new pages)

How Token Sales Work
├── The Basics
├── Why Token Sales Matter
├── Are You Ready?
├── Choosing Your Sale Type
├── Running Your Sale
└── After Your Sale

Sale Types
├── Overview
├── Liquidity Bootstrapping Pools (LBPs)
├── Continuous Clearing Auctions (CCAs)
└── Fixed-Price Sales

Compliance
├── Overview
├── KYC & Verification
├── Geo-Restrictions
└── Vesting & Lockups

Post-Launch Tooling
├── Overview
├── Governance
├── Voting & Delegation
├── Staking & Incentives
└── Security Councils

Benefits
├── Overview
├── For Projects
└── For Participants

Developers
├── Overview
├── API Documentation
└── Smart Contracts

Key Improvements

• Shallower navigation: Max 2 levels vs previous 4-5
• Clear user journey: Why → Ready? → Choose → Run → After
• Explicit persona paths: "For Projects" vs "For Participants"
• Governance deprioritized: Moved to "Post-Launch Tooling"
• Problem/solution framing: Added "Why Token Sales" and problem context before features

Content Notes

• Pages with <<TODO: ... >> markers indicate content that needs to be written by the team (specific metrics, case studies, compliance details, API specs, etc.)
• Existing content from token-sales-and-icos.md has been incorporated
• GPT-5.2 external review was performed and feedback incorporated

GPT-5.2 Review Recommendations (for follow-up PRs)

1. Add participant journey pages (how to participate, claims, troubleshooting)
2. Complete compliance TODOs (geo list, KYC providers, disclaimers)
3. Add contract addresses + audit links
4. Include case studies with metrics
5. Consider role-based entry points ("I'm a project" / "I'm a participant")

Test plan

• Verify all internal links work in GitBook preview
• Review each new page for content accuracy
• Fill in <<TODO>> markers with actual content
• Test navigation flow from landing page through sale journey

🤖 Generated with Claude Code