Wiki Revision History
Every wiki page maintains complete version history. Each save creates a revision, allowing you to view past versions, compare changes, understand who modified what, and restore previous content if needed.
Understanding Revisions
What Is a Revision
A revision is a saved snapshot of a page at a specific moment:
- Content: Complete page text at save time
- Title: Page title (if changed)
- Author: Who made the change
- Timestamp: When saved
- Revision number: Sequential identifier
When Revisions Create
New revision created when:
- Page first created (revision 1)
- Edit mode saved with changes
- Restoration from older version
- Import or bulk update operations
Revision Retention
All revisions are preserved indefinitely:
- No automatic pruning
- Complete audit trail
- Storage optimized for text
Accessing Revision History
From Page View
- Select a wiki page
- Look at right sidebar
- Find "Revision History" button
- Shows revision count (e.g., "Revision History (12)")
- Click to open modal
Revision Modal
The modal displays:
- List of all revisions
- Newest first (descending order)
- Each entry shows: date, author, summary
- Navigation for long lists
Revision List
Entry Information
Each revision shows:
| Field | Description |
|---|---|
| Revision # | Sequential number |
| Date | When saved (relative or absolute) |
| Author | Who made the change |
| Preview | Snippet or change summary |
Identifying Changes
Revisions may indicate:
- "Page created" for first revision
- "Content updated" for edits
- "Title changed" if title modified
- "Restored from revision X" for restorations
Viewing a Revision
Preview Content
- Click any revision in list
- Preview panel shows content
- Read-only view of that version
- Full page content displayed
Comparing to Current
Preview clearly indicates:
- This is historical content
- Current version may differ
- Restore option available
Comparing Revisions
Opening Diff View
- In revision modal, select first revision
- Hold Ctrl/Cmd and select second revision
- Click "Compare" button
- Diff modal opens
Understanding Diffs
The comparison shows:
Added content: Highlighted in green Removed content: Highlighted in red Unchanged: Normal display
Line-by-Line View
Diff displays changes contextually:
- Added lines marked with +
- Removed lines marked with -
- Surrounding context for clarity
Character-Level Diffs
Within changed lines:
- Specific word changes highlighted
- Fine-grained modification tracking
- Easier to spot small edits
Restoring Revisions
When to Restore
Restoration useful when:
- Accidental deletion of content
- Previous version was better
- Undoing someone else's changes
- Recovering from mistakes
Restore Process
- Open revision history
- Select desired revision
- Preview to confirm correct version
- Click "Restore" button
- Confirm restoration
After Restoration
- Page content replaced with old version
- New revision created (restoration tracked)
- Original versions preserved
- Restoration author recorded
Restoration Is Reversible
Restoration creates a new revision, so:
- You can restore again
- Nothing permanently lost
- Full audit trail maintained
Auditing Changes
Who Changed What
Revision history answers:
- Who last edited this page?
- When did specific content appear?
- What did it look like before?
- How has it evolved?
Compliance Use
For regulated environments:
- Complete change history
- Author accountability
- Timestamp verification
- No deleted history
Team Accountability
Revisions help with:
- Training new editors
- Reviewing contributions
- Understanding documentation evolution
- Resolving conflicting edits
Best Practices
Meaningful Saves
Don't save empty or trivial changes:
- Complete logical units of work
- Avoid "fix typo" commits
- Group related changes
Regular Checkpoints
For long editing sessions:
- Save periodically
- Each save is a recovery point
- Better to have extra revisions
Review Before Restore
Before restoring old content:
- Preview the revision
- Check what might be lost
- Consider copy-paste instead
- Document why restoring
Clean Up Through Editing
Rather than restoring old versions:
- Edit current version to fix
- Keep accumulated improvements
- Selective rollback when needed
Limitations
No Partial Restore
Restoration replaces entire page:
- Cannot restore single paragraph
- Copy-paste for partial recovery
- Manual merge if needed
No Delete Revisions
Individual revisions cannot be deleted:
- Complete history preserved
- By design for audit purposes
- Contact support for edge cases
Large Revisions
Very large pages may:
- Take longer to diff
- Have truncated previews
- Still function correctly
Common Scenarios
Accidental Content Deletion
- Notice content is missing
- Open revision history
- Find last revision with content
- Preview to confirm
- Restore or copy-paste
Unwanted Edit by Team Member
- See change you disagree with
- Open revision history
- Find pre-change revision
- Discuss with team first
- Restore if agreed
Understanding Evolution
- New to the document
- Open revision history
- Browse through versions
- Understand how decisions evolved
- Get context for current state
Merge Conflict Resolution
When two people edited:
- See unexpected content
- Compare recent revisions
- Identify both contributions
- Manually merge best of both
- Save combined version
Troubleshooting
No revisions showing:
- New page has only one revision
- Check permissions to view history
- Try refreshing modal
Diff not working:
- Select exactly two revisions
- Check browser compatibility
- Very large pages may timeout
Restore fails:
- Check edit permissions
- Verify page isn't locked
- Network issues may interrupt
Old revision looks wrong:
- Format changes over time
- Content is accurate
- Rendering may differ
Permissions
Revision access follows page permissions:
| Role | View History | Restore |
|---|---|---|
| Agency Owner | ✓ | ✓ |
| Manager | ✓ | ✓ |
| Developer | ✓ | ✓ (own pages) |
| Client | ✓ (if view enabled) | ✗ |
Some environments may restrict history access.