Skip to content

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.

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.

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.

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.

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.

The right column displays:

  • Description — The graph’s description, with an edit button for authorized users.
  • Created — The date the graph was created.
  • 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 with wh graph content get org/graph --kind readme, edit it with wh graph content set org/graph --kind readme --file readme.md, or view version history with wh thing history Readme.
  • See Content Shape for the full CLI, SDK, MCP, and raw HTTP fetch matrix.