Skip to content

README, both languages, and two claims that were no longer true - #154

Merged
WaylandYang merged 2 commits into
devfrom
docs/readme-rewrite
Aug 31, 2026
Merged

README, both languages, and two claims that were no longer true#154
WaylandYang merged 2 commits into
devfrom
docs/readme-rewrite

Conversation

@WaylandYang

Copy link
Copy Markdown
Contributor

The features section had grown into a wall of prose, and several of its claims had gone stale.
Both READMEs are reworked around a capability table, and the video placeholder is now a real
demo.

The opening

A positioning line was added under the lede, in both languages: this is not an open-source take
on Palantir, it is a different route to enterprise intelligence, built bottom up from knowledge
governance to trustworthy decisions and simulation. The comparison is drawn against knowledge
graphs and vector stores, which is the category we actually differ from.

Philosophy is now two paragraphs instead of one, and the two languages are deliberately not
literal translations of each other. Em dashes are gone from the English file entirely.

The demo

The placeholder is replaced by the attachment from #152.
It is anchored to a published discussion rather than an orphaned upload, so nothing depends on
an asset that no content references.

<video> tags do not survive GitHub's sanitiser in a repository context, and neither does a
relative src, so the bare attachment URL is the only form that renders a player. The comment
above it now says so.

Two things in the table were no longer true

Cold start. It claimed every knowledge base ships with a built-in ontology of person,
organization, project, product, event, concept, location "and the relations among them". None of
that is still seeded: built-in classes went in 0009, and the seed relations went across 0010,
#125 and 0011. graph.rs says it plainly, that a base has only the vocabulary its user imported.
Cold start comes from the packs now, which was the point of 0008, so the row names them and links
to a pack request.

Encoding detection was described as being for Chinese sources. chardetng is Mozilla's
general detector and covers the whole legacy set, so the row no longer scopes it to one language.

What was added

Capabilities present in the product but absent from the table: a complete application, the agent
harness and its multi-turn tool calling, conflict detection as its own entry, and decision
intelligence marked in development and linked to the roadmap. Mapping exploration was added to
ontology-driven querying, and role levels to permissions.

The nine existing entries keep their content. English rows went from 792 words to about 600 by
cutting mechanism detail that belongs in the ADRs, not by dropping claims. The BIRD Mini-Dev
figures are now a link rather than four numbers inline.

The roadmap is aligned across both languages.

@WaylandYang
WaylandYang merged commit 0a3ec95 into dev Aug 31, 2026
3 checks passed
@WaylandYang
WaylandYang deleted the docs/readme-rewrite branch August 31, 2026 23:01
@WaylandYang WaylandYang mentioned this pull request Aug 31, 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