Spaces & Organization
Organize your documentation with teams and spaces
Sleeve uses a hierarchical structure to help you organize documentation across your entire organization. Understanding this structure is key to effective documentation management.
Organization Hierarchy
Levels Explained
Top Level: Your company or main entity
- One per company/workspace
- Contains all teams and their documentation
- Users are members of organizations
Team Level: Groups within your organization
- Team members have specific roles and permissions
- Can have multiple spaces
Project Level: Collections of related documents
- Can be public (org-wide) or private (team-only)
- Linked to GitHub repositories for version control
Content Level: Individual pages
- Written in Markdown/MDX
- Can include rich components
- Automatically versioned
Understanding Spaces
Spaces are the primary way to organize related documentation. Think of them as projects or documentation sites.
Space Types
Public Spaces
Visibility: All organization members
Use Cases:
- Company-wide knowledge base
- Public API documentation
- Shared best practices
- Product documentation
Note: "Public" means visible to anyone in your organization, not the internet
Private Spaces
Visibility: Team members only
Use Cases:
- Internal team processes
- Confidential specifications
- Work-in-progress documentation
- Security-sensitive information
Note: Only accessible to users with explicit team membership
Creating a Space
Go to the team where you want to create a space
Click the "+ New Space" button
Basic Information:
- Name: Descriptive name (e.g., "API Documentation")
- Slug: URL-friendly identifier (auto-generated)
- Description: Brief overview of the space's purpose
- Icon: Choose an emoji to represent the space
Choose between:
- Private (default): Team members only
- Public: All organization members
Click "Create" to finalize your space
Start with private spaces and make them public when the content is ready for wider consumption.
Managing Teams
Teams represent departments or groups within your organization and control access to spaces and documents.
Team Roles
Adding Team Members
Go to the team you want to add members to
Click the "Share" button in the top-right
Type the email address of the person you want to invite
Choose their role: Admin or Member
Click "Invite" to send them an email invitation
On the free plan, you can add 1 additional person to a team. Upgrade for unlimited team members.
Best Practices
Clear Structure
Use logical groupings and clear naming conventions
Index Pages
Create overview pages that link to related docs
Consistent Naming
Follow a naming pattern across all documents
Use Folders
Group related docs in subdirectories (via Edit Layout button or docs.json in GitHub)
With a well-organized space structure, your team can find and contribute to documentation efficiently!