---
title: "Semantic Graph"
description: "Understanding your site's Semantic Graph — how content is organized, connected, and governed."
canonical_url: "https://docs.bulkheados.com/content/"
template: "page-node"
schema_type: "WebPage"
---

<div class="docs-content">
<p class="docs-lead">Everything on your Bulkhead OS site lives in the <strong>Semantic Graph</strong> — a knowledge graph where pages, posts, events, and articles are all <em>nodes</em> connected by typed relationships. You manage all of this from the Library in your admin dashboard.</p>

<h2 id="library">The Library</h2>
<p>The Library is your Semantic Graph workspace. It shows every node you've created, organized in a 3-pane layout: the global sidebar on the left, a Context Explorer tree in the middle, and the node editor on the right. Use the tree to browse by navigation structure or see all nodes, and click any item to open it in the editor.</p>

<h2 id="lifecycle">Content Lifecycle</h2>
<table>
<thead><tr><th>Status</th><th>Visible to public?</th><th>Use case</th></tr></thead>
<tbody>
<tr><td><strong>Draft</strong></td><td>No</td><td>Work in progress</td></tr>
<tr><td><strong>Published</strong></td><td>Yes</td><td>Live on your site</td></tr>
<tr><td><strong>Archived</strong></td><td>No</td><td>Removed but not deleted</td></tr>
</tbody>
</table>

<h2 id="example-driven-authoring">Example-Driven Authoring</h2>
<p>The fastest docs are usually written from examples outward. Bulkhead OS supports prose, structured callouts, highlighted code snippets, and lightweight feedback loops without making authors leave the editor.</p>

<div class="docs-example-grid">
  <a class="docs-example-card" href="/content/code-blocks">
    <span class="docs-example-card__eyebrow">Shiki</span>
    <strong class="docs-example-card__title">Code blocks that teach, not just decorate</strong>
    <span class="docs-example-card__body">Use language labels, readable shells, JSON payloads, and copy actions to keep docs practical.</span>
  </a>
  <a class="docs-example-card" href="/content/feedback">
    <span class="docs-example-card__eyebrow">Feedback</span>
    <strong class="docs-example-card__title">Close the loop after the article</strong>
    <span class="docs-example-card__body">Capture whether the page helped, then use that signal to decide where examples are missing.</span>
  </a>
</div>

<p>Explore the sections below to learn about content types, formatting, media, and example-heavy docs patterns.</p>
</div>
