Onboarding Guide
Onboarding Guide
Welcome! This guide will help you and your team get started with our platform quickly and efficiently.
Getting Started
Step 1: Create Your Account
To begin, you'll need to create an account:
- Visit our sign-up page
- Enter your email address
- Verify your email through the confirmation link
- Complete your profile setup
Use your work email address to ensure you get access to all team features automatically.
Step 2: Set Up Your Workspace
Once your account is created, you'll want to set up your workspace:
- Choose a workspace name that represents your team or project
- Invite team members by sending them email invitations
- Configure your settings to match your team's preferences
Step 3: Connect Your First Integration
Our platform works best when connected to your existing tools:
Connect your GitHub repositories to automatically sync your documentation.
- Go to Settings → Integrations
- Click "Connect GitHub"
- Authorize the connection
- Select repositories to sync
Key Features to Explore
Documentation Management
- Create pages using our intuitive editor
- Organize content with folders and tags
- Collaborate with your team in real-time
- Version control to track changes over time
Team Collaboration
- Assign roles to team members (Admin, Editor, Viewer)
- Set permissions for different sections
- Track activity with detailed logs
- Communicate using comments and mentions
Customization
- Brand your workspace with custom logos and colors
- Configure navigation to match your structure
- Set up custom domains for your documentation
- Customize the theme to match your brand
Best Practices
For Team Leads
- Set up your workspace structure before inviting team members
- Define clear roles and permissions from the start
- Create templates for common documentation types
- Establish workflows for content review and publishing
For Content Creators
- Start with an outline before writing full content
- Use consistent formatting across all pages
- Add metadata (tags, categories) to improve discoverability
- Review and update content regularly
For Developers
- Use our API to automate documentation updates
- Set up webhooks for real-time synchronization
- Integrate with CI/CD pipelines for automated publishing
- Leverage our SDK for custom integrations
Common Tasks
Inviting Team Members
To invite new team members:
- Navigate to Settings → Team
- Click "Invite Member"
- Enter their email address
- Select their role (Admin, Editor, or Viewer)
- Click "Send Invitation"
They'll receive an email with instructions to join your workspace.
Creating Your First Page
- Click "New Page" in the sidebar
- Choose a template or start from scratch
- Add your content using our markdown editor
- Add metadata (title, description, tags)
- Click "Publish" when ready
Setting Up Custom Domain
- Go to Settings → Domains
- Click "Add Custom Domain"
- Enter your domain name
- Follow the DNS configuration instructions
- Verify your domain ownership
Troubleshooting
Can't Access Workspace
If you're having trouble accessing your workspace:
- Check that you're using the correct email address
- Verify your account is activated
- Contact your workspace administrator
- Check your email for invitation links
Integration Not Working
If an integration isn't working:
- Verify your API credentials are correct
- Check the integration status in Settings
- Review the integration logs for errors
- Ensure you have the necessary permissions
Content Not Publishing
If your content isn't publishing:
- Check that you have Editor or Admin permissions
- Verify the page isn't in draft mode
- Review any validation errors
- Check your publishing workflow settings
Next Steps
Now that you're onboarded, here are some recommended next steps:
Explore Templates
Browse our collection of documentation templates
API Reference
Learn about our API endpoints
Best Practices
Read our documentation best practices guide
Need Help?
If you have questions or need assistance:
- Documentation: Browse our help center
- Community: Join our Slack community
- Support: Email us at support@example.com
- Status: Check our status page
Welcome aboard! We're excited to have you here.