User Experience Overview¶
This documentation suite guides you through using ClearPath (institutional governance) and FairWins (open markets). Rather than listing features, these guides show how real people accomplish their goals through interconnected narratives that build intuition about the system's logic.
Documentation Structure¶
User Journeys explores typical paths from discovering the platform through sophisticated engagement. See how DAO members participate in governance, traders evaluate proposals, and market creators attract participants. The flow emphasizes experience over isolated actions.
Practical Scenarios presents eight concrete stories (Sarah, Marcus, Elena, David, Lisa, Robert, Maya, Tom) demonstrating real usage patterns: proposal submission, trading strategies, market creation, oracle reporting, challenging reports, ragequit, portfolio management, and anti-coercion.
Understanding the Interface walks through what you see and why, explaining dashboards, proposal/market views, trading interfaces, and portfolio management. The interface enables your decisions without prescribing them.
Using the System provides structured guidance about connecting wallets, navigating sections, understanding lifecycles, managing portfolios, and interpreting states. More instructional but still user-focused.
Submitting Proposals and Trading on Markets dive deeper into specific activities, combining narrative with practical examples. They provide frameworks for thinking about these decisions without prescribing choices.
FAQ answers common questions about concepts, participation requirements, technical details, and procedures.
Reading Paths¶
New users: Start with Getting Started, then User Journeys.
Proposers: Read Submitting Proposals, Sarah's story in Practical Scenarios, and relevant User Journeys sections.
Traders: Begin with Trading on Markets, Marcus's story, and trading sections of User Journeys.
Market creators: Focus on FairWins sections of User Journeys and Elena's story in Practical Scenarios.
Evaluators: Read Introduction sections of User Journeys and Understanding the Interface, skim Practical Scenarios for diverse use cases.
Documentation Philosophy¶
Narrative over lists: Paragraphs flow naturally rather than defaulting to bullets. Lists appear only when genuinely appropriate.
User perspective: Everything framed from your viewpoint. We ask "what do you see and why might you care" rather than "what does the system do."
Context over instructions: We explain what you're accomplishing, what information matters for decisions, and what results from actions. Interface changes, but concepts and decision processes remain stable.
Respect for judgment: We never tell you whether to trade PASS or FAIL, whether to submit proposals, or whether prices are correct. We help you understand factors that matter, how to evaluate information, and what consequences follow.
Honesty about complexity: We manage complexity through progressive disclosure rather than oversimplification. Basic concepts in straightforward language. Deeper details when needed. Technical mechanisms when relevant to decisions.
Connecting Experience to Purpose¶
These guides help you understand why the system works the way it does and how your participation contributes to larger goals.
Futarchy as governance: ClearPath implements "vote on values, bet on beliefs." Your trading contributes to collective intelligence helping the DAO make better decisions.
Open prediction markets: FairWins makes markets accessible beyond governance. Your fair market creation and informed trading expand the ecosystem.
Privacy-preserving infrastructure: Zero-knowledge proofs, encrypted positions, and key-change capabilities protect honest participation. We explain these features in terms of what they enable for you.
Living Documentation¶
This documentation evolves with the platform and user needs. If sections confuse, questions aren't addressed, or your experience differs from descriptions, that feedback improves future versions.
The documentation succeeds when it helps you accomplish goals with confidence, whether participating in DAO governance, creating/trading on markets, or exploring futarchy and prediction markets generally.
Getting Started¶
Choose your entry point based on immediate interests. Documents interconnect, so follow curiosity, use cross-references when topics interest you, and return to sections as understanding develops. The best reading path serves your needs right now.