🧠 PolicyDraft.org Tutorial
🎮 Gamification System: Costs & Rewards
PolicyDraft.org uses a reputation and token system to gamify contributions. Every action has a cost or reward.
Look for the ⭐ indicators throughout the interface to see what each action does!
📖 How to Read the Indicators
- ⭐ +rep = Content owner gets reputation when you do this action
- ⭐ +X.X = Content owner gets X.X points when you do this
- ⭐ -X tokens = This action costs X tokens (uses your daily quota)
- ⭐ +X tokens = This action gives you X tokens (reduces daily usage)
Key Insight: You earn reputation when others interact with your content, not when you create it!
💰 Actions That Cost Tokens
Content Creation
- Create Node: -1 token (+rep when others interact)
- Edit Node: -1 token (only owner can edit)
- Create Edge/Connection: -1 token (target owner gets +2.0 points)
- Upload Essay: -3 to -8 tokens (dynamic pricing)
- Generate Whitepaper: -5 to -15 tokens (dynamic pricing)
- Bulk Create Nodes: -20 tokens
Thematic Ownership
- Create Thematic: -10 tokens (requires 50+ reputation)
- Pay Thematic Maintenance: -X tokens (variable, maintains thematic ownership)
📊 Dynamic AI Pricing
AI-powered features (Essay Upload, Whitepaper Generation) use dynamic pricing based on system AI budget availability:
- When budget is plentiful: Costs are lower (minimum ~50% of base cost)
- When budget is tight: Costs increase (up to ~150% of base cost)
- Check the current cost displayed on buttons before using AI features
🎁 Actions That Give Rewards
Token Rewards
- Accept Merge Proposal: +5 tokens (reduces daily usage)
- Rank Improvement: +10 points per rank (daily bonus, can't lose points)
Reputation Rewards (to Content Owner)
- View Node: +1.0 point (free action for viewer)
- Connect to Node: +2.0 points (costs 1 token for connector)
- Search (node appears): +0.5 points (free action for searcher)
- Like Node: +0.5 to +3.0 points (based on liker's reputation, free action)
- Like Publication: +0.5 to +3.0 points (based on liker's reputation, free action)
📉 Reputation Decay
⚠️ Haven't Liked Publications in 7+ Days
- Decay: -0.5 points per week
- Maximum: -2 points per month
- Prevention: Like at least one publication every 7 days (free action!)
📊 Daily Quota System
Your daily action limit is based on your reputation score and role:
OBSERVER
0 actions/day
Read-only access
CONTRIBUTOR
max(2, floor(reputation)) actions/day
Minimum 2 actions, scales with reputation
MODERATOR
max(10, reputation) actions/day
Minimum 10 actions, scales with reputation
ADMIN / FOUNDER
100 actions/day
Effectively unlimited
Pro Tip: The more valuable content you create, the more others interact with it, the higher your reputation,
and the more daily actions you can perform! It's a positive feedback loop. Your quota resets at midnight each day.
Important: Self-interactions don't count! You don't get reputation when you view or expand your own nodes.
Also note: only you can edit your own nodes - others cannot edit them.
The system is designed to reward collaboration through connections, views, and likes.
🎯 Getting Started
Welcome to PolicyDraft.org! This is a gamified knowledge graph platform where you can create, connect, and explore ideas through nodes and relationships.
Start by exploring the existing graph to understand how nodes and connections work before creating your own content.
Notice the point indicators next to buttons - they show you what each action does!
📊 Graph Interface
Navigation & Controls
🔍 Search ⭐ +0.5
Use the search bar to find nodes by title or summary. Search results will highlight matching nodes on the graph.
Gamification: When your nodes appear in search results, you get +0.5 points per match!
📋 Loading Modes
Choose how to load nodes:
- Saved Layout: Your previously saved workspace
- Recently Worked On: Nodes you've interacted with recently
- Most Visited: Your most frequently viewed nodes
- All Nodes: Every active node in the system
🎨 Canvas Controls
Interact with the graph:
- Drag: Move nodes around
- Zoom: Mouse wheel or pinch
- Pan: Click and drag empty space
- Select: Click on nodes
Node Interactions
- Click a node to view its details in the modal
- Drag nodes to organize your workspace
- Use Actions dropdown for advanced operations
- Press Delete/Backspace to remove selected nodes from canvas
➕ Creating Content
Creating Nodes
- Click the "Create Node" button
- Fill in the title (required)
- Add a summary to describe the concept
- Select appropriate tags for categorization
- Click "Create Node" to add it to the graph
Good node titles are concise and descriptive. Summaries should explain the concept clearly for other users.
Creating Connections
- Click on a node to open its details
- Click "Connect..." in the Actions dropdown
- Select the target node from the dropdown
- Choose a relation type (e.g., "relates_to", "causes", "part_of")
- Click "Create Connection"
Creating Connected Nodes
- Click on a node to open its details
- Click "Create Connected Node" in the Actions dropdown
- Fill in the new node details
- Specify the relation between the nodes
- Click "Create Node" - the connection is made automatically
Use "Create Connected Node" when you want to create a new concept that's directly related to an existing one.
🎮 Gamification & Reputation System
⭐ How Points Work
PolicyDraft.org is gamified! Every action you take can earn you reputation points or cost you tokens.
Look for the ⭐ +rep and ⭐ -X tokens hints next to buttons to see what each action does.
💰 Token System (Daily Actions)
Tokens represent your daily action quota. Each action costs tokens:
⭐ Actions That Cost Tokens
- Create Node: -1 token (owner gets reputation when others interact)
- Edit Node: -1 token (only the owner can edit their node)
- Create Edge: -1 token (target owner gets reputation)
- Upload Essay: -3 to -8 tokens (dynamic pricing based on AI budget)
- Generate Whitepaper: -5 to -15 tokens (dynamic pricing based on AI budget)
- Bulk Create Nodes: -20 tokens
🎁 Actions That Give Rewards
- Accept Merge Proposal: +5 tokens (reduces daily usage)
- Create Valuable Content: Others interact → You get reputation
- Rank Improvement: +10 points per rank gained daily
📈 Reputation System (How You Earn Points)
Key Insight: You earn reputation when others interact with your content, not when you create it!
When Others View Your Node
+1.0 point
Automatically tracked when someone clicks your node
When Others Like Your Node
+0.5 to +3.0 points
Based on the liker's reputation score
When Others Connect to Your Node
+2.0 points
When someone creates an edge pointing to your node
When Others Like Your Publication
+0.5 to +3.0 points
Based on the liker's reputation score
When Your Node Appears in Search
+0.5 points
Automatically tracked when your node matches a search
🎯 Daily Quota System
Your daily action limit is based on your reputation score:
- CONTRIBUTOR: max(2, floor(reputation_score)) actions per day
- MODERATOR: max(10, reputation_score) actions per day
- ADMIN/FOUNDER: 100 actions per day (unlimited)
- OBSERVER: 0 actions per day (read-only)
Pro Tip: The more valuable content you create, the more others interact with it, the higher your reputation,
and the more daily actions you can perform! It's a positive feedback loop.
Important: Your quota resets at midnight each day. Plan your actions accordingly!
🏆 Leaderboard & Rankings
Compete with other users:
- Main Leaderboard: Top users by total reputation score
- Risers: Users with biggest 30-day growth
- Daily Ranking Bonus: +10 points per rank improvement (can't lose points)
- Expertise Dimensions: Track your expertise by tags/domains
Check the leaderboard regularly to see your progress and compete with top contributors!
📧 Nightly Digest Notifications
Every night, you'll receive a comprehensive digest notification summarizing:
📊 Node Activity Summary
- Views on your nodes
- Likes received
- Edits by others
- New connections
- Top 5 most active nodes
📈 Reputation Changes
- Daily reputation gain/loss
- Current total reputation
- Breakdown by activity type
💡 Personalized Recommendations
- Actions to improve engagement
- Connection suggestions
- Thematic organization tips
- Reputation growth strategies
Pro Tip: Check your notifications daily to see what's happening with your content and get actionable recommendations for improvement!
What Triggers Recommendations?
- Low Activity: If your nodes aren't getting engagement, we'll suggest ways to improve visibility
- Missing Thematics: We'll remind you to create or organize thematics to help with discovery
- Connection Opportunities: We'll highlight orphaned nodes that could be connected
- Publication Likes: We'll remind you to like publications to maintain reputation
- Reputation Milestones: We'll guide you toward the next level
- Low Token Balance: You'll receive a warning when your daily token usage is running low
📚 Publications & Whitepapers
Generating Whitepapers
- Ensure you have enough tokens remaining (5-15 tokens depending on dynamic pricing)
- Click the "Generate Whitepaper" button - the current cost is shown on the button
- Wait for AI processing (may take 30-60 seconds)
- View the generated whitepaper in the publications page
Whitepapers are AI-generated documents that synthesize information from your current graph view. The token cost varies based on AI budget availability.
Viewing Publications
- Navigate to the Publications page
- Browse the list of generated whitepapers
- Click on any publication to view its full content
- See metadata including author, creation date, and node count
🏆 Leaderboard & Rankings
Understanding Rankings
The leaderboard shows:
- Top Contributors: Users with highest total reputation
- Top Risers: Users with biggest reputation gains recently
- Your Position: Your current ranking in the system
Check the leaderboard regularly to see how your contributions compare to other users.
⚙️ Admin Features ADMIN FOUNDER
User Management
Admins and founders can:
- View all users in the system
- Search users by name or email
- See user roles and reputation scores
- Manage user permissions
Node Management
Advanced node operations:
- Deactivate Nodes: Hide nodes from all users while keeping them in the database
- Remove from Canvas: Remove nodes from your personal workspace
- Audit Logs: Track all system changes and user actions
Deactivating a node will hide it from all users and API responses. This action is logged and should be used carefully.
⌨️ Keyboard Shortcuts
Canvas Navigation
- Mouse Wheel: Zoom in/out
- Click + Drag: Pan around
- Double-click: Reset zoom
Node Operations
- Delete/Backspace: Remove selected node from canvas
- Click: Select node
- Drag: Move node
Form Shortcuts
- Enter: Submit forms
- Escape: Close modals
- Tab: Navigate form fields
🔧 Troubleshooting
Common Issues
Can't create nodes or connections
- Check your daily quota in the header
- Ensure you're logged in
- Try refreshing the page
Nodes not appearing
- Try different loading modes
- Check if nodes were deactivated by an admin
- Clear browser cache and refresh
Whitepaper generation fails
- Ensure you have enough tokens (check the cost displayed on the button)
- Check your internet connection
- Wait a moment and try again - AI budget may have been temporarily exhausted
Admin features not visible
- Verify you have ADMIN or FOUNDER role
- Log out and log back in
- Contact a founder for role assignment
💡 Best Practices
Creating Quality Content
- Clear Titles: Use descriptive, concise titles
- Helpful Summaries: Explain concepts clearly for others
- Appropriate Tags: Use relevant tags for categorization
- Meaningful Connections: Connect related concepts with clear relationships
Organizing Your Workspace
- Save Layouts: Your positions are automatically saved
- Use Loading Modes: Switch between different node sets
- Remove Unwanted Nodes: Clean up your canvas regularly
- Group Related Concepts: Position related nodes near each other
Collaboration Tips
- Build on Others' Work: Connect to existing nodes when possible (owners get +2.0 points!)
- Use Standard Relations: Stick to common relationship types
- Document Your Ideas: Write clear summaries for complex concepts
- Like Quality Content: Like nodes and publications to reward good contributors (free action!)
- Respect the Community: Follow the reputation system and daily limits
🚀 Advanced Features
Canvas Layout Management
Your workspace management features:
- Checkpoints: Save named snapshots of your workspace to restore later
- Auto-save: Node positions are automatically saved as you work
- Load Modes: Choose how to load nodes (saved layout, recent, popular, all)
- Fit to View: Pan and zoom to fit all visible nodes
- Fullscreen: Enter fullscreen mode for focused work
Thematic Organization
- Load Thematics: Load all nodes in a specific thematic category
- Create Thematic: Create and own a thematic category (requires 50+ reputation, costs 10 tokens)
- Filter by Thematic: Use thematic filter in search
- Browse by Thematic: See all thematics with node counts
Tag Management
- Tag Input with Autocomplete: Type to see suggestions from existing tags
- Tag Browser: Browse all available tags with usage counts
- Tag Chips: Visual tags with X button to remove
- Tag Suggestions: See most-used tags as you type
Bulk Operations
- Select Nodes: Click "Select for Bulk Action" in node details
- Bulk Actions Button: Shows count of selected nodes
- Thematic Ownership: Own and maintain thematics through engagement (creating nodes/edges in your thematic)
- Visual Selection: Selected nodes show blue border
Activity Tracking
The system tracks your interactions to provide:
- Recently Worked On: Nodes you've interacted with recently
- Most Visited: Your most frequently viewed nodes
- My Content: View only nodes you created
- Reputation Tracking: See your reputation score and expertise breakdown
Merge Proposals
- AI Merge Proposals: AI suggests merging similar nodes
- Accept Proposals: Get +5 tokens when you accept
- User-to-User Proposals: Propose merges to other users (can share tokens)
- View Proposals: See all proposals in Account page
Notifications
- Notification Badge: Red badge in navbar shows unread count
- Notification Types: Node connected, edited, liked, merge proposals, etc.
- Mark as Read: Individual or bulk mark as read
- Real-time Updates: Notifications appear as events happen
📋 Complete Activity Reference
Graph Page Actions
Node Actions
- Create Node (-1 token) (+rep when others interact)
- Edit Node (-1 token) (owner only)
- Like Node (free) (owner gets +0.5 to +3.0)
- Connect to Node (-1 token) (target owner +2.0)
- View Node (free) (owner +1.0)
- Expand Node
- Focus Node
- Select for Bulk Action
- Hide Node
- Deactivate Node (admin)
Content Creation
- Upload Essay (-3 to -8 tokens, dynamic)
- Generate Whitepaper (-5 to -15 tokens, dynamic)
- Create Edge (-1 token) (target owner +2.0)
- Search (free) (node owners +0.5)
Workspace Management
- Save Checkpoint
- Load Checkpoint
- Load Thematics
- Create Thematic (if you have 50+ reputation)
- Bulk Actions
- Fit to View
- Fullscreen
- Clear Canvas
- My Content
- Share Workspace
Account Page Actions
Account Management
- Change Password
- Update Email
- Request Level Upgrade
- Export Data
- Delete Account
- View Sessions
- Revoke Session
Merge Proposals
- Accept Proposal (+5 tokens)
- Reject Proposal
- Initiate Proposal
- View Proposals
Notifications
- View Notifications
- Mark as Read
- Mark All Read
- Click to Navigate
Other Pages
Leaderboard
- View Rankings
- View Risers
- View Expertise
- Search Users
Publications
- View Publications
- View Details
- Filter Publications
Admin (Admin/Founder Only)
- Manage Users
- Update Roles
- Trigger AI Merges
- Auto-Tag Nodes
- Review Flagged Nodes
📞 Getting Help
If you need assistance:
- Check this tutorial for common solutions
- Contact an admin for technical issues
- Report bugs through the admin interface
- Suggest features to improve the platform
The PolicyDraft.org community thrives on collaboration. Don't hesitate to reach out if you have questions or ideas!