Skip to content

docs: integrate iscc.ai copilot widget#118

Merged
titusz merged 6 commits into
mainfrom
develop
Jun 1, 2026
Merged

docs: integrate iscc.ai copilot widget#118
titusz merged 6 commits into
mainfrom
develop

Conversation

@titusz

@titusz titusz commented Jun 1, 2026

Copy link
Copy Markdown
Member

Summary

Two documentation changes on top of the just-merged modernization baseline (#114):

  1. Features page rewrite — ISO 24138-accurate content: adds the Semantic-Code, frames SIMPRINTS as a metadata sibling (not packed into the ISCC-CODE), floats the three diagrams in two-column blocks with a GLightbox lightbox, and adds iscc-algo-design3.svg. Includes minor History page wording refinements.
  2. Rename Features → Capabilitiesdocs/features.mddocs/capabilities.md, reframing the page as the ISCC's capabilities rather than product-style features (avoids the product/marketing register for a standard).

URL compatibility

  • /capabilities/ is the new canonical path.
  • /features/ is preserved as a Zensical forwarding page (location: /capabilities/), mirroring the existing /implementations/ stub. Forwarding is client-side (JS location.replace + <noscript> meta-refresh) — GitHub Pages cannot emit server-side 301s.
  • scripts/check_site_paths.py updated: /capabilities/ canonical, /features/ demoted to a compatibility path with a forwarding-source check.
  • maintainers/site-migration.md redirect map updated.

Validation

  • prek run --all-files clean (ISCC-SUM stamp regenerated)
  • check_site_paths.py passes for source and --site-dir site
  • zensical build --clean clean
  • Rendered nav: Overview → Capabilities → Concept → History → Specification → Resources → License

titusz added 6 commits May 31, 2026 22:09
Rewrite the Concept page around layered sameness and content-derived
codes, dropping the dated blockchain-era proof-of-concept framing. Align
the Capabilities wording, reorder top-level navigation, widen content on
large screens, and refresh the documentation ISCC-SUM stamp.
Force the audience cards into three equal columns on wide screens and
stack them on narrow ones, replacing the auto-fit grid that only fit two.
Refresh the Resources page to drop retired third-party implementations
and add the Cover Matching demo, normalize index dashes, and regenerate
the documentation ISCC-SUM stamp.
Sweep em-dashes from the docs prose and README, replacing them with
hyphens for a plainer typographic style, and regenerate the
documentation ISCC-SUM stamp.
- Style the repository-card grid and status badges in custom.css
- Add the iscc-lib polyglot core library card under Core components
- Reorder ecosystem cards and tidy entries on the resources page
- Use numeric date ranges for ISO WG 18 convenors in history.md
- Rename the top-level navigation label to "iscc-codes"
- Regenerate the documentation ISCC-SUM stamp
- Drop the Active Dev and Exp legend entries, no longer used by any card
- Break the Draft legend entry onto its own line below Stable and Beta
- Point the homepage algorithmic-design figure at iscc-algo-design3.svg
- Regenerate the documentation ISCC-SUM stamp
Load the Chainlit copilot from https://iscc.ai and mount it with anonymous JWT auth, themed to the ISCC brand and corrected for Zensical's 125% root font-size.

- zensical.toml: add extra_javascript (copilot loader + mounter)
- docs/javascripts/copilot.js: fetch token and mount the widget
- docs/stylesheets/copilot.css: ISCC brand theme for the widget

Also folds in working-tree changes that share the docs ISCC-SUM tree
hash and so must commit together: README badge refresh, favicon update,
and the regenerated documentation stamp.
@titusz titusz merged commit 480da6a into main Jun 1, 2026
3 checks passed
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