User Guide
Welcome to the Conducky User Guide!
This section is for all users of Conducky, including event attendees, Code of Conduct team members, and event administrators. If you're using Conducky's interface to incident reports, respond to incidents, or manage events, this guide is for you.
🚀 New to Conducky?
Start here for the fastest way to get up and running:
📚 What's Covered
Core Features
- Getting Started - Account creation, first login, and initial setup
- Profile Management - Managing your account and personal settings
- Authentication - Logging in, password management, and account security
- Navigation - Understanding the interface and finding what you need
Event Participation
- Event Management - Joining events, understanding roles, event workflows
- User Management - Managing users within events (for Event Admins)
- Invite Links - Creating and managing invite links (for Event Admins)
- Public Event Pages - Understanding public event information
Incident Management
- Report Submission - How to submit incident reports
- Incident Comments - Communication and collaboration on incidents
- Cross-Event Incidents - Managing incidents across multiple events
Communication & Updates
- Notification Center - Managing alerts and updates
- Recent Updates - Latest features and improvements
Support & Help
- FAQ - Frequently asked questions and quick answers
- Troubleshooting - Common issues and solutions for users
👥 Who This Guide Is For
Event Attendees (Reporters)
If you're attending an event and may need to incident reports:
- Start with: Quick Start → Report Submission
- Key sections: Authentication, Navigation, FAQ
- Your role: Submit incidents, track your submissions, communicate with response teams
Code of Conduct Team Members (Responders)
If you're part of the safety/response team for events:
- Start with: Quick Start → Getting Started → Navigation
- Key sections: Report Comments, Cross-Event Incidents, Notification Center
- Your role: Review and respond to incidents, manage incident workflows, maintain team communication
Event Administrators (Event Admins)
If you manage events and their safety teams:
- Start with: Quick Start → Event Management → User Management
- Key sections: Invite Links, Team Management, Public Event Pages
- Your role: Set up events, manage teams, oversee incident response processes
Organization Administrators (Org Admins)
If you manage multiple events within an organization:
- Start with: Quick Start → Event Management → Organization Management
- Key sections: Multi-Event Management, Organization Settings, Cross-Event Analytics
- Your role: Oversee multiple events, manage organization-wide policies, coordinate between events
Organization Viewers (Org Viewers)
If you need read-only access to multiple events within an organization:
- Start with: Quick Start → Navigation → Cross-Event Incidents
- Key sections: Multi-Event Dashboard, Cross-Event Reporting, Organization Overview
- Your role: Monitor multiple events, view cross-event trends, provide oversight
System Users (Multi-Event)
If you participate in multiple events with different roles:
- Start with: Navigation → Cross-Event Incidents
- Key sections: Profile Management, Notification Center, Event Management
- Your role: Efficiently manage multiple event contexts and responsibilities
🎯 User Roles Explained
Understanding your role helps you focus on the most relevant documentation:
| Role | Can Submit Incidents | Can View All Incidents | Can Manage Users | Can Configure Events | Can Manage Organizations |
|---|---|---|---|---|---|
| Reporter | ✅ | ❌ (own only) | ❌ | ❌ | ❌ |
| Responder | ✅ | ✅ | ❌ | ❌ | ❌ |
| Event Admin | ✅ | ✅ | ✅ | ✅ | ❌ |
| Org Admin | ✅ | ✅ | ✅ | ✅ | ✅ |
| Org Viewer | ❌ | ✅ (read-only) | ❌ | ❌ | ❌ |
| System Admin | ✅* | ✅* | ✅* | ✅ | ✅ |
*System Admins need explicit event roles to access event data
🔗 Quick Navigation
By Task
- I need to submit an incident → Quick Start → Getting Started
- I can't access something → Troubleshooting → FAQ
- I need to invite someone → Invite Links → User Management
- I'm managing multiple events → Cross-Event Incidents → Navigation
- I need to train my team → Quick Start → Navigation → Incident Comments
By Experience Level
- Brand new to Conducky → Quick Start
- Familiar but need specifics → FAQ → Specific feature guides
- Experienced user → Use the sidebar navigation to jump to specific topics
- Training others → Quick Start → Getting Started → Role-specific sections
📋 Not What You're Looking For?
System Administration
If you're responsible for installing, deploying, or managing the Conducky system itself:
- Go to: Admin Guide - System setup, deployment, and maintenance
Development and API
If you're building integrations or contributing code to Conducky:
- Go to: Developer Docs - API reference, architecture, and development guides
API Integration
If you need to integrate Conducky with other systems:
- Go to: API Reference - Complete API documentation with examples
🆘 Need Immediate Help?
Quick Problem Solving
- Can't log in or access features? → Troubleshooting
- Navigation not working? → Troubleshooting
- Report submission problems? → Troubleshooting
- General questions? → FAQ
Contact Support
- Event-specific issues: Contact your event administrators
- Account or system issues: Contact your system administrators
- Bug incidents: GitHub Issues
- Community help: GitHub Discussions
🏁 Ready to Begin?
Choose your starting point based on your needs: