UBEC Protocol User Guides

📥 Download PDF ← All Guides

UBEC Protocol User Guides

Welcome to the UBEC Protocol user guide library. This directory contains comprehensive guides for all types of participants in the Ubuntu Bioregional Economic Commons ecosystem.

Quick Navigation

🌟 Start Here

  • Participation Guide - Main entry point for all new users. Discover how you can participate and which pathway is right for you.

Guides by User Type

💰 Token Holders & Economic Participants

  • Token Holders User Guide - Comprehensive guide for anyone holding and transacting with UBEC tokens
  • Understanding the four-token system
  • Building your holonic score
  • Best practices for Ubuntu-aligned participation
  • Advanced features and strategies

🌱 Core Beneficiaries (Grant Recipients)

These guides are for the four groups receiving 65% of UBEC token allocation:

  • Onboarding Overview - Common information for all core beneficiaries
  • Getting started checklist
  • Technical setup (Stellar wallet)
  • Understanding holonic evaluation
  • Support and resources

Individual Onboarding Guides: - Farmer Onboarding Guide - Small-scale farmers transitioning to regenerative practices - Community Onboarding Guide - Groups building collective food sovereignty - Community Activator Onboarding Guide - Facilitators helping communities thrive - Living Lab Onboarding Guide - Educational institutions integrating environmental monitoring

Reference: - Core Beneficiary Profiles - Detailed profile definitions, eligibility criteria, and application processes

🤝 Community Roles

🏛️ Governance

  • Governance Participant Guide - For token holders participating in protocol governance
  • Understanding governance structures
  • Proposal processes
  • Voting mechanisms
  • Building influence through Ubuntu alignment

💻 Technical Roles

  • Developer Onboarding Guide - For software developers and technical contributors
  • Core development
  • Integration development
  • API usage

  • Contributing to codebase

  • System Administrator Guide - For those managing UBEC infrastructure

  • System setup and configuration
  • Monitoring and maintenance
  • Incident response

  • Security best practices

  • Technical Operator Guide - For DevOps and operations professionals

  • Deployment procedures
  • Performance optimization
  • Troubleshooting
  • Operations protocols

🌍 General Public

  • Public Guide - For anyone curious about UBEC and Ubuntu economics
  • Understanding the basics
  • Exploring the philosophy
  • Staying informed
  • Finding your entry point

Supporting Documentation

Core Concepts

  • User Group Definitions - Complete taxonomy of all UBEC user types
  • Detailed characteristics
  • Needs and tools
  • Success metrics
  • Journey stages

Architecture & Technical

  • Architecture Overview - System design and component relationships (coming soon)
  • Database Schema - Data models and relationships (coming soon)
  • API Reference - Complete REST API documentation (coming soon)
  • Python SDK - Official Python library documentation (coming soon)

How to Use These Guides

1. First-Time Visitors

👉 Start with the Participation Guide to understand: - What UBEC is and how it works - Different ways to participate - Which pathway fits your interests and skills - Next steps for getting started

2. Choosing Your Pathway

After reading the Participation Guide, select the detailed guide for your chosen role: - If you want to participate economically → Token Holder Guide - If you're a farmer → Farmer Onboarding Guide - If you're organizing a community food project → Community Onboarding Guide - If you facilitate community development → Community Activator Onboarding Guide - If you run an educational institution with land → Living Lab Onboarding Guide - If you want to grow UBEC locally → Community Organizer Guide - If you're a developer → Developer Guide - If you want to help govern → Governance Guide - If you manage infrastructure → System Administrator or Technical Operator Guide - If you're just exploring → Public Guide

3. Going Deeper

Most guides include: - ✅ Step-by-step instructions - 📋 Checklists and templates - 💡 Examples and case studies - ⚠️ Common pitfalls and how to avoid them - 🔗 Links to additional resources - 📞 Support contacts

4. Staying Current

These guides are living documents that evolve with the ecosystem: - Check document version and date - Subscribe to updates newsletter - Join community forums for latest discussions - Provide feedback to help improve guides

Quick Reference: User Journey Stages

All participants move through these stages regardless of role:

🔵 Stage 1: Awareness

  • You are here if: Learning about UBEC
  • Your focus: Understanding the basics
  • Your resources: Participation Guide, Public Guide
  • Next step: Choose your pathway

🟠 Stage 2: Onboarding

  • You are here if: First 30 days of participation
  • Your focus: Setup and first interactions
  • Your resources: Role-specific onboarding guides
  • Next step: Complete technical setup, first transactions

🟡 Stage 3: Activation

  • You are here if: 30-90 days of engagement
  • Your focus: Building habits and relationships
  • Your resources: Quick start checklists, community connections
  • Next step: Regular participation, skill development

🟢 Stage 4: Retention

  • You are here if: 90+ days of ongoing participation
  • Your focus: Deepening commitment and impact
  • Your resources: Advanced features, leadership opportunities
  • Next step: Mentoring others, system improvement

🟣 Stage 5: Advocacy

  • You are here if: Experienced, committed participant
  • Your focus: Growing the network, leadership
  • Your resources: Governance participation, ambassador programs
  • Next step: Elder status, strategic contributions

Frequently Asked Questions

Which guide should I read first?

Start with the Participation Guide. It will direct you to the appropriate detailed guides based on your interests and role.

Can I participate in multiple ways?

Yes! Many people have multiple roles. For example, a farmer might also be a token holder and participate in governance. However, focus on your primary relationship when applying for grants or structured programs.

Do I need technical knowledge?

Most roles (token holders, farmers, community members, organizers, living labs) require no technical background. Developers and system administrators need relevant technical skills.

How long does onboarding take?

  • Token Holders: 1-2 hours for wallet setup and first transactions
  • Core Beneficiaries: 30-90 days application process, then structured onboarding
  • Community Organizers: 1-2 weeks training, then ongoing support
  • Developers: Self-paced based on contribution goals
  • Administrators: 1-2 weeks comprehensive training

Where can I get help?

Each guide includes specific support channels. Generally: - Community questions: forums.ubec.protocol - Technical issues: dev.ubec.protocol
- Application support: beneficiaries@ubec.protocol - General inquiries: hello@ubec.protocol

Are these guides available in other languages?

Currently, guides are in English. We're working on: - Spanish (Q1 2026) - French (Q1 2026) - Portuguese (Q2 2026) - Additional languages based on community needs

How do I provide feedback on guides?

We welcome your input! Please: 1. Use feedback forms linked in each guide 2. Suggest improvements via community forums 3. Email documentation@ubec.protocol 4. Contribute directly via GitHub (for technical contributors)

Document Standards

All guides in this directory follow these principles:

Design Principles

Following UBEC's 12 Project Design Principles: 1. Modular, focused content - Each guide addresses one user type 2. Clear step-by-step instructions - Action-oriented guidance 3. Single source of truth - No duplicate information across guides 4. No redundant information - Shared content in Overview, linked from guides 5. Comprehensive documentation - Everything needed for success 6. Attribution to contributors - Recognition for all involved 7. Regular updates based on feedback - Living documents

Documentation Format

  • Clear structure with logical sections
  • Action-oriented with concrete steps
  • Example-rich with real scenarios
  • Accessible language for target audience
  • Visual aids where helpful (diagrams, screenshots)
  • Version control with dates and revision history

Accessibility

  • Plain language with technical terms explained
  • Graduated complexity from simple to advanced
  • Multiple formats planned (text, video, interactive)
  • Mobile-friendly for on-the-go reference

Contributing to Guides

Found an Error?

  • Report via community forums
  • Email documentation@ubec.protocol
  • Submit issue on GitHub (technical contributors)

Want to Improve a Guide?

  1. Review current version
  2. Identify specific improvements
  3. Submit suggestions with rationale
  4. Participate in review process

Want to Create New Guide?

  1. Identify gap in current documentation
  2. Propose outline to documentation team
  3. Draft following standards above
  4. Submit for review and editing
  5. Collaborate on revisions

Translation Volunteers

If you can translate guides to other languages: 1. Contact documentation@ubec.protocol 2. Review translation guidelines 3. Coordinate with language team 4. Submit translations for review

Changelog

Version 1.2 - November 9, 2025

  • 🔧 Modularized onboarding guides into separate files for better maintainability
  • 📚 Created UBEC_Onboarding_Overview.md with shared content
  • 📄 Split into 4 individual guide files (Farmer, Community, Activator, Living Lab)
  • 🔗 Updated all cross-references and links
  • ✅ Improved navigation and reduced file sizes

Version 1.1 - November 9, 2025

  • ✨ Added Living Labs as fourth core beneficiary category
  • 📝 Updated all references from "three groups" to "four groups"
  • 🌱 Added Living Lab pathway to guide navigation
  • 🔄 Updated FAQ to include living labs

Version 1.0 - November 8, 2025

  • ✨ Initial release of guide directory
  • 📝 Created comprehensive Participation Guide
  • 🔗 Organized links to all existing guides
  • 📋 Established directory structure

Attribution

This project uses the services of Claude and Anthropic PBC to inform our decisions and recommendations. This project was made possible with the assistance of Claude and Anthropic PBC.

Contact & Support

Documentation Team: documentation@ubec.protocol
Community Support: forums.ubec.protocol
General Inquiries: hello@ubec.protocol

Website: ubec.protocol
Documentation: docs.ubec.protocol

Welcome to UBEC. We're glad you're here. 🌱

"I am because we are. You are because we are. We are because Ubuntu."