Handbook

1. Open Handbook from the admin sidebar under Content.
2. Stay on the Current tab.

You land on the published handbook at /admin/handbook. Edit handbook opens /admin/handbook/edit with the Markdown editor. The preview uses the same safe Markdown renderer members see. Raw HTML stays disabled. Unpublished edits stay on the edit workflow until you publish.

The header shows Status (published revision or not published yet), Last published with publisher when available, and a header actions menu with Edit handbook.

1. Open Handbook from the admin sidebar under Content.
2. Open the header actions menu and choose Edit handbook to open /admin/handbook/edit.
3. Update the Markdown in Handbook Markdown.
4. Choose Preview changes when you are ready for the next step.

The edit page autosaves while you work so you can leave without losing progress. Choose Preview changes at the bottom when your edits finish saving; that opens /admin/handbook/edit/preview.

1. Open Edit handbook and make your Markdown changes.
2. Choose Preview changes at the bottom of the edit page.
3. Review the rendered handbook on /admin/handbook/edit/preview.
4. Choose Back to edit to keep editing, or Publish when the preview looks right.

The preview step uses the same safe Markdown renderer members see. It shows your current saved draft, not the published handbook on the Current tab.

1. Open Preview changes after your edits finish saving.
2. Choose Publish on the preview step.
3. Enter a nonblank Change summary that describes what changed for other admins.
4. Choose Publish in the confirmation dialog.

Publishing requires changes since the last publish and a saved edit session with no save in progress. A successful publish reports the new revision number, returns you to the published handbook on the Current tab, and updates the member handbook immediately. The change summary is stored in admin revision history only; members read the updated handbook content, not the summary.

1. Open Handbook from the admin sidebar under Content.
2. Choose the Revisions tab.
3. Review published revisions newest-first. Each row shows the revision number, publication time, publisher, and change summary.
4. Open any revision to read its complete immutable Markdown snapshot.

Revision history is admin-only and read-only. Members see only the current published handbook, not past revisions or change summaries. Compare, restore, edit, and delete actions are not available here.

1. Open Handbook and choose the Revisions tab.
2. Choose a revision number from the list.

The snapshot page shows publication metadata and renders the complete handbook Markdown through the same safe renderer used elsewhere in Opal. Raw HTML stays disabled.