Client documentation

This section is written for people who need to use or evaluate Knowspread without reading the Rails codebase. It starts from real operating situations: launching a company space, creating users, assigning learning, checking completion, and connecting external systems.

Start by role

Role	Read first	Typical question
Project owner	Owner runbook	Are we ready to launch and how do we keep control?
HR / L&D manager	Content and assignments	How do I make sure the right people get the right learning?
Administrator	Users and groups	How do users, roles, states, and groups work?
Reviewer	QA and acceptance	What should be checked before rollout?
Integrator	Client integrations	Which identifiers, API calls, and webhooks matter?

Core workflows

flowchart LR
  Setup[Configure space] --> Users[Create or import users]
  Users --> Groups[Organize users into groups]
  Groups --> Content[Prepare content]
  Content --> Assign[Assign learning]
  Assign --> Study[Learners study]
  Study --> Report[Check reporting and certificates]
  Report --> Improve[Fix data, content, or process]

Practical reading path

1. Roles and scenarios
2. Owner runbook
3. Getting started with Knowspread
4. Users and groups
5. Content and assignments
6. Reporting and certificates
7. QA and acceptance
8. Screenshot and UI map
9. Client integrations