Skip to content

World graph: a section for reading a world, and element type as the one word - #10

Closed
tmoosting wants to merge 7 commits into
mainfrom
world-graph
Closed

tmoosting wants to merge 7 commits into
mainfrom
world-graph

Conversation

@tmoosting

Copy link
Copy Markdown
Member

A section for reading a world as a graph, and one word for the 22.

World graph, a new sidebar section

  • Overview (/docs/world-graph, new): a world as a typed graph; three ways to read part of one (a lens, the draught, the graph itself); four related ideas (fisheye views, Magic Lenses, bidirectional lenses, ontology modules); and where a world sits next to other knowledge bases.
  • Lenses (/docs/lenses) and A world as a graph (/docs/lenses/graph): the same pages at the same addresses, now in this section.
  • The draught (/docs/world-graph/draught, new): the concept, linking the route page, which keeps its full content and address in the API section.

Moves

  • The lens routes move to API › Lenses (/docs/development/api/lenses). The old /docs/lenses/api stays as a short real page naming the routes and pointing on.
  • Sidebar order: Start · Schema · World graph · Tools · AI agents · SDKs · Games · API · Resources. The API section moves lower.
  • A worked example moves to the end of Schema, after the element types.
  • The changelog links onlyworlds.com's own Changelog.

One word: element type

"Element type" replaces "category" for the 22 in 153 places: the prose, the figures, the element page generator and the figure checks. Kept as they are:

  • the URLs (element_categories);
  • other tools' own categories;
  • the standard's field text.

Where the word meant a world's own sorting, it is now "kinds". The fields page says it once: an element's type is one of the 22; its supertype is the first sorting inside that type, and its subtype sorts further.

A word rule in verify-public-words.mjs fails on "categor…" in built prose, outside the changelog, code, link targets and two allowed phrases. A planted "the 22 categories" failed it (exit 1).

The draught pages name the Character neutrally ("they", "the Character").

Checks

npm run check passes: the link validator, the URL contract (193 rows), the figures, the public words and the word rule. Every old address serves real content.

🤖 Generated with Claude Code

tmoosting and others added 6 commits October 29, 2026 00:51
A new section between Schema and Tools: an overview at /docs/world-graph (a world as typed elements and links, the three ways to read part of one, the ideas it sits beside), Lenses and A world as a graph at their old addresses, and a short concept page for the draught at /docs/world-graph/draught that links the route page, which keeps its address and content. The lens routes move to the API section at /docs/development/api/lenses; /docs/lenses/api stays a short page naming the routes and pointing there, and its links are re-pointed. The sidebar now runs Start, Schema, World graph, Tools, AI agents, SDKs, Games, API, Resources, and the worked example closes the Schema section. llms.txt's Lenses set becomes the World graph set. Each new page is a row in the URL contract.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
The generic Character on the draught route page was "she" and "her"; it is now "the Character" or "they" and "their", with the figure's held words changed the same way. The owner's view-as example names what it takes, `?as=<character id>`. The field `her_links` keeps its name.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Every page, figure and generated element page now calls the 22 element types, never categories; the old paths under /docs/schema/element_categories stay, as do the standard's own field descriptions, quoted code, and plain English that means another tool's categories. Where a word meant a world's own sorting it is now "kinds", and Fields says once how the three nest: an element's type is one of the 22, its supertype the first sorting inside that type, its subtype the next. Supertype and subtype keep their names.

verify-public-words.mjs now fails on any word starting "categor" in a built page's prose or its Markdown twin, outside the changelog's dated entries, the element pages' generated field tables, code, link targets and two allowed plain-English phrases. It does not read the llms text files, attribute text or the figures' client-side captions, and catches no synonym. Planted "the 22 categories" on a page: exit 1, found on the page and its twin; removed: exit 0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
One entry under 2026-10-28 for the new section, the moves and the word. The intro's pointer to onlyworlds.com's own log is its own line and names it by its current name and address, Changelog at /changelog (the old What's new address redirects there).

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…d study and an internal test taken out; the four ideas named as four)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…wo papers that show it

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
…pe (the one public word, after the sharper definitions merged)

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@tmoosting

Copy link
Copy Markdown
Member Author

Merged to main as 52e2254..cc0c3fe, the same seven commits replayed onto the current main (conflicts resolved toward main's newer text; the element type wording re-applied where main had changed a line since). Live with deploy e395f18.

@tmoosting tmoosting closed this Oct 29, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant