What is a Case?
A case is a self-contained knowledge record containing:- Title: A clear, descriptive headline
- Body: Detailed narrative explaining the problem, solution, or process
- Evidence: Supporting files (photos, logs, PDFs, measurements)
- Tags: Custom labels for organization and discovery
- State: Tracks the case through its lifecycle
Case Lifecycle
Cases progress through five distinct states:Draft
Initial creation. Only visible to creators and their team. Edit freely.
In Review
Submitted for review. Assigned reviewers examine and provide feedback.
Verified
Approved by reviewers. Considered reliable knowledge ready for publication.
Published
Active in your knowledge base. Discoverable via search and browsing.
Deprecated
Marked as outdated. Archived for historical reference, not recommended for new use.
Creating a Case
Click New Case in the dashboard. You’ll enter:- Case Title – Be specific and descriptive
- Body – Use markdown for formatting. Include context, steps, outcomes, and lessons learned
- Tags – Assign custom tags for filtering and search
- Evidence – Attach supporting files (optional initially; add anytime)
Editing Cases
Edit cases in Draft or In Review states by clicking the Edit button. Published cases require moving back to Draft first. All edits create an audit trail visible in the case’s activity log.Case Templates
If your workspace admin has created case templates, you’ll see template options when creating a new case. Templates are designed for specific scenarios (e.g., “Equipment Failure Analysis” or “Process Improvement”). Using a template:- Pre-fills common sections and structure
- Ensures consistency across similar cases
- Speeds up case creation
Audit Log
Every case maintains a complete history. Click Activity in the case view to see:- Creation and modification timestamps
- Who made each change
- State transitions (Draft → In Review, etc.)
- Comments and reviewer feedback
Best Practices
Keep titles specific and searchable
Keep titles specific and searchable
Instead of “Equipment Issue,” use “Motor Bearing Failure: XYZ-2000 Unit, March 2026.”
Include why, not just what
Include why, not just what
Explain not only what happened but why it matters and what was learned.
Add evidence early
Add evidence early
Don’t wait until review. Attach photos, logs, and measurements as you document.
Link related cases
Link related cases
Next Steps
Evidence
Learn how to attach and organize supporting files.
Review Workflow
Understand how cases move through approval cycles.