About
The About tab is the default view when you open a graph. It provides a high-level overview of the graph’s purpose and data model.
Two-Column Layout
Section titled “Two-Column Layout”The About tab uses a two-column layout. The main content area on the left displays the README and data dictionary. A narrower sidebar on the right shows graph metadata.
README
Section titled “README”The left column leads with the graph’s README, rendered as Markdown with full GitHub Flavored Markdown (GFM) support — including tables, task lists, and fenced code blocks.
The README is stored as Readme — a well-known instance of the built-in Content shape. The same content is accessible via wh graph content get <org/graph> --kind readme, client.graph.getReadme, and GET /{org}/{graph}/readme.md.
Editing the README
Section titled “Editing the README”If you have write access, an edit button appears above the README. Clicking it switches to a Markdown editor where you can:
- Write or revise the content in a plain Markdown textarea.
- Save your changes, which are committed automatically with an appropriate message (e.g., “Update README”).
If the graph does not yet have a README, authorized users see a prompt to create one.
Data Dictionary
Section titled “Data Dictionary”Below the README, the data dictionary section lists every shape defined in the graph alongside its fields and types — a quick reference for understanding the data model without leaving the About tab.
Each shape entry collapses by default. The summary row shows:
- Shape name — the identifier used in commits and assertions.
- Description — a short inline summary, when the shape definition includes one.
- Component badge — the source component, when the shape was installed via a component.
- Version badge — the current version of the shape definition (e.g.
v3). - Instance count — the total things and assertions for this shape, when greater than zero.
- Field count — the number of fields the shape defines.
Expand an entry to see the field grid: each field’s name, type (e.g. string, number, boolean), and description. When the shape has matching things, a View N things button appears at the bottom of the expanded view. Clicking it navigates to the Things tab filtered to that shape.
The deep-link URL takes the form ?tab=things&shapes=<name>. Include tab to switch away from the default About tab. Each jump creates a browser-history entry, so the Back button returns you to the prior About state.
Sidebar
Section titled “Sidebar”The right column displays:
- Description — The graph’s description, with an edit button for authorized users.
- Created — The date the graph was created.
CLI Equivalents
Section titled “CLI Equivalents”- To list shapes from the terminal, use
wh shape list. - To inspect shape fields from the terminal, use
wh shape view <name>. - To inspect graph-level schema context, use
wh graph describe [org/graph]. - README content is stored as
Readme; fetch it withwh graph content get org/graph --kind readme, edit it withwh graph content set org/graph --kind readme --file readme.md, or view version history withwh thing history Readme. - See Content Shape for the full CLI, SDK, MCP, and raw HTTP fetch matrix.