Skip to content

Fix documentation inaccuracies against LinkedDataHub 5.6.0#51

Merged
namedgraph merged 1 commit into
developfrom
docs/accuracy-5.6.0
Jul 12, 2026
Merged

Fix documentation inaccuracies against LinkedDataHub 5.6.0#51
namedgraph merged 1 commit into
developfrom
docs/accuracy-5.6.0

Conversation

@namedgraph

Copy link
Copy Markdown
Member

Corrects documentation inaccuracies found by auditing the docs/ sources against the LinkedDataHub 5.6.0 release code (verified against master). All edited files pass trig --validate.

User interface reference (reference/user-interface.ttl)

  • Removed the stale System containers section (Latest/Files/Imports/Queries/Geo/Charts shortcuts) — these no longer exist. Replaced with an accurate Other views section (only Geo and Latest survive, as sidebar buttons).
  • Corrected the class-based navigation description: it's a flat, data-driven list of the rdf:type values present in the data (with instance counts), opening a dialog of instances — not an rdfs:subClassOf "class tree".
  • Moved the keyword search box into the left sidebar (where it actually renders); the navbar section now describes the URI address bar and right-side menus.
  • Added a Right sidebar section documenting backlinks and related results / parallax (previously undocumented).

Reference

  • command-line-interface: admin/ontologies/add-construct.shadd-constructor.sh (matches bin/).
  • administration/ontologies: ACL ontology namespace …/linkeddatahub/acl#…/linkeddatahub/admin/acl# (per LACL.java / lacl.ttl).
  • data-model/resources/views: layout-modes list now includes the Graph mode (ac:GraphMode, added in 5.4.0).
  • configuration: documented the four released CLIENT_* HTTP client timeout env vars (defaults 120000 / 10000 / 300000 / 10000 ms).

User guide

  • navigate-data & search-data: class navigation corrected as above; keyword search box is in the left sidebar, not the navigation bar.
  • import-csv-data & import-rdf-data: the Queries container is now reached via the document tree (its left-nav shortcut was removed; the container itself still exists).
  • Fixed dangling internal anchors #left-nav, #right-nav, #create-edit.

Not changed (verified accurate)

HTTP API methods/status codes & PATCH semantics, Linked Data proxy, ACL modes/vocab, ontology/package model, CSV/RDF imports, content-block type constraint, class/property URIs, triplestores, dataspace/dataset, get-started/setup. Unreleased env vars (WEBID_CACHE_EXPIRATION/JWKS_CACHE_EXPIRATION) are intentionally left undocumented for 5.6.0.

Note

docs/html/** build artifacts are not included — regenerate with make ttl-to-html before publishing.

🤖 Generated with Claude Code

User interface reference:
- Replace the stale "System containers" section with class-based
  navigation and an "Other views" section (Geo, Latest)
- Relocate the search box to the left sidebar; describe the navbar
  URI address bar and right-side menus instead of a keyword search
- Add a "Right sidebar" section (backlinks, related results/parallax)

Reference:
- command-line-interface: admin/ontologies/add-construct.sh -> add-constructor.sh
- administration/ontologies: ACL namespace .../acl# -> .../admin/acl#
- data-model/resources/views: add the Graph layout mode
- configuration: document the CLIENT_* HTTP client timeout env vars

User guide:
- navigate-data, search-data: class navigation is a flat, data-driven
  type list; the keyword search box lives in the left sidebar
- import-csv-data, import-rdf-data: the Queries container is reached via
  the document tree (no more system-container shortcut)
- Fix dangling #left-nav / #right-nav / #create-edit anchors

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@namedgraph namedgraph merged commit 477649a into develop Jul 12, 2026
3 checks passed
@namedgraph namedgraph deleted the docs/accuracy-5.6.0 branch July 12, 2026 20:56
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