From a95c5d81098ac637e0e1c0653b8a723ac889380d Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 8 Aug 2026 02:37:14 +0000 Subject: [PATCH 1/2] docs: update where-docs-live and activity log for new hub repos Co-authored-by: Ryan Johnson --- docs/modules/ROOT/pages/activity-log.adoc | 1 + docs/modules/ROOT/pages/where-docs-live.adoc | 4 +++- 2 files changed, 4 insertions(+), 1 deletion(-) diff --git a/docs/modules/ROOT/pages/activity-log.adoc b/docs/modules/ROOT/pages/activity-log.adoc index 6902f7c..e517511 100644 --- a/docs/modules/ROOT/pages/activity-log.adoc +++ b/docs/modules/ROOT/pages/activity-log.adoc @@ -8,6 +8,7 @@ This page records significant documentation and project activity at an org level === August +* **agent-rules, ver, issues-browser** — Registered three Antora components on the hub: xref:tools/agent-rules.adoc[Agent Rules] (modular agent rules assembly), xref:tools/ver.adoc[Ver] (universal VCS library/CLI/GUI), and xref:tools/issues-browser.adoc[Issues Browser] (forge metadata backup; renamed from `issue-tracker`). Playbooks point at `issues-browser`, `agent-rules`, and `ver` repos; xref:tools/issue-tracker.adoc[Issue Tracker] kept as a redirect stub. * **valentus-theme head-meta sync** — Restored font-size FOUC + `site-font-size.css` in the supplemental `head-meta.hbs` overlay (was missing after brand fork). Condensed A/A/A control hides on desktop again and scales doc text on mobile. Playbooks already use rolling `v2`. * **valentus-theme product topic** — This repo (and other Valentus playbooks) tagged with GitHub topic `valentus-theme` for dependency rediscovery; convention documented upstream. * **DOS naming** — Public category stays Development Orchestration Suite; DevOps framed as one facet of the suite; *Dev OS* as quiet mental model only. Sites + DevCentr vision/capabilities docs updated. diff --git a/docs/modules/ROOT/pages/where-docs-live.adoc b/docs/modules/ROOT/pages/where-docs-live.adoc index 5f1f022..570a0f4 100644 --- a/docs/modules/ROOT/pages/where-docs-live.adoc +++ b/docs/modules/ROOT/pages/where-docs-live.adoc @@ -12,7 +12,9 @@ This site (docs.devcentr.org) is built by the link:https://github.com/dev-centr/ * **templates** — Standardized project templates and usage guides. * **easy-installer** (product **Ibex**) — Install Builder Extension: installer projects, in-place PATH, plugin ABI, shell hooks. * **msi-generator** — MSI/MSIX generator documentation (engine used by Ibex plugins). -* **issue-tracker** — Local GitHub issues browser (GUI/CLI); syncs issues into SQLite for offline browse/search. +* **issues-browser** — Forge metadata backup (issues, PRs, discussions) into central SQLite archives; GUI/CLI/daemon/tray for offline browse and monitoring. Formerly `issue-tracker`. +* **agent-rules** — Forkable modular agent rules (`RULES.md`, `general/`, `profiles/`) for local AI coding assistants. +* **ver** — Universal version-control interface (Git, SVN, Mercurial) — DUB library, CLI, and optional Qt GUI. * **agentic-email-integration** — Own-your-inbox Gmail integration (Himalaya + agents). * **fixnow-dev** — FixNow pressure-driven issue tracking: AI value scoring, countdown badges, and resolution verification. From 5cf8f30ecc447d33f406fc660c94d4e50a49f9d1 Mon Sep 17 00:00:00 2001 From: Cursor Agent Date: Sat, 8 Aug 2026 02:37:16 +0000 Subject: [PATCH 2/2] docs: add changelog structure, README badges, and nav entry Co-authored-by: Ryan Johnson --- README.adoc | 7 ++- docs/modules/ROOT/nav.adoc | 1 + .../2025-03-lunr-search.adoc | 12 +++++ .../2026-03-central-todo-activity-log.adoc | 13 ++++++ .../2026-07-fixnow-dev-hub.adoc | 12 +++++ .../2026-08-07-valentus-head-meta-sync.adoc | 12 +++++ .../2026-08-07-wire-issue-tracker.adoc | 12 +++++ ...8-wire-agent-rules-ver-issues-browser.adoc | 45 +++++++++++++++++++ docs/modules/ROOT/pages/changelog.adoc | 19 ++++++++ 9 files changed, 132 insertions(+), 1 deletion(-) create mode 100644 docs/modules/ROOT/pages/changelog-details/2025-03-lunr-search.adoc create mode 100644 docs/modules/ROOT/pages/changelog-details/2026-03-central-todo-activity-log.adoc create mode 100644 docs/modules/ROOT/pages/changelog-details/2026-07-fixnow-dev-hub.adoc create mode 100644 docs/modules/ROOT/pages/changelog-details/2026-08-07-valentus-head-meta-sync.adoc create mode 100644 docs/modules/ROOT/pages/changelog-details/2026-08-07-wire-issue-tracker.adoc create mode 100644 docs/modules/ROOT/pages/changelog-details/2026-08-08-wire-agent-rules-ver-issues-browser.adoc create mode 100644 docs/modules/ROOT/pages/changelog.adoc diff --git a/README.adoc b/README.adoc index d471cf0..304b49b 100644 --- a/README.adoc +++ b/README.adoc @@ -12,6 +12,9 @@ ifdef::env-github[] Stars Issues
+Docs +Deploy +

Dev-Centr Documentation

Dev-Centr documentation hub. Antora site aggregating dev-centr projects.
@@ -29,6 +32,8 @@ image:https://img.shields.io/github/contributors/dev-centr/docs.svg?style=for-th image:https://img.shields.io/github/forks/dev-centr/docs.svg?style=for-the-badge[Forks,link=https://github.com/dev-centr/docs/network/members] image:https://img.shields.io/github/stars/dev-centr/docs.svg?style=for-the-badge[Stars,link=https://github.com/dev-centr/docs/stargazers] image:https://img.shields.io/github/issues/dev-centr/docs.svg?style=for-the-badge[Issues,link=https://github.com/dev-centr/docs/issues] +image:https://img.shields.io/badge/docs-Dev--Centr-22c55e?style=for-the-badge[Docs,link=https://docs.devcentr.org] +image:https://github.com/dev-centr/docs/actions/workflows/deploy.yml/badge.svg?style=for-the-badge[Deploy,link=https://github.com/dev-centr/docs/actions/workflows/deploy.yml] = Dev-Centr Documentation @@ -48,7 +53,7 @@ This repository contains the Antora playbook and configuration for the **Dev Cen |=== | File | Description | `antora-playbook.yml` | Production Antora playbook. Uses remote GitHub URLs for all content sources and the published UI bundle. Used by CI/CD. -| `antora-playbook-local.yml` | Local sibling-repo playbook (committed). Expects `../devcentr`, `../templates`, `../general-knowledge`, `../msi-generator`, and `../easy-installer` beside this repo. +| `antora-playbook-local.yml` | Local sibling-repo playbook (committed). Expects sibling checkouts (e.g. `../devcentr`, `../templates`, `../general-knowledge`, `../issues-browser`, `../agent-rules`, `../ver`, `../msi-generator`, `../easy-installer`) beside this repo. See the playbook file for the full list. | `antora-playbook.testing.yml` | Same local content sources, but points `ui.bundle` at `../valentus-theme/build/ui-bundle.zip` for theme work. | `supplemental-ui/` | Site overlay on the valentus-theme 2.x UI bundle: custom domain `CNAME`, accent-token brand CSS, header logo under `img/`, and a thin `head-meta.hbs` fork that loads the brand stylesheet. Header logo / navbar text use playbook `site.keys`. | `.vscode/` | VS Code folder settings and extension recommendations for this playbook repo. diff --git a/docs/modules/ROOT/nav.adoc b/docs/modules/ROOT/nav.adoc index 88e9633..e721ef4 100644 --- a/docs/modules/ROOT/nav.adoc +++ b/docs/modules/ROOT/nav.adoc @@ -1,5 +1,6 @@ * xref:index.adoc[Home] * xref:where-docs-live.adoc[Where Documentation Lives] +* xref:changelog.adoc[Changelog] * xref:todo-roadmap.adoc[Todo & Roadmap] * xref:activity-log.adoc[Activity Log] * Architecture diff --git a/docs/modules/ROOT/pages/changelog-details/2025-03-lunr-search.adoc b/docs/modules/ROOT/pages/changelog-details/2025-03-lunr-search.adoc new file mode 100644 index 0000000..050f1fc --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2025-03-lunr-search.adoc @@ -0,0 +1,12 @@ += 2025-03 — Lunr full-text search +:navtitle: 2025-03 +:page-layout: article + +== Summary + +Enabled client-side full-text search via `@antora/lunr-extension` on all playbooks. Documented as an essential extension in xref:publishing/antora-essential-extensions.adoc[Antora essential extensions]. + +== Affected codepaths + +* `package.json` — `@antora/lunr-extension` dependency +* `antora-playbook*.yml` — Lunr extension registration diff --git a/docs/modules/ROOT/pages/changelog-details/2026-03-central-todo-activity-log.adoc b/docs/modules/ROOT/pages/changelog-details/2026-03-central-todo-activity-log.adoc new file mode 100644 index 0000000..44bba32 --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2026-03-central-todo-activity-log.adoc @@ -0,0 +1,13 @@ += 2026-03 — Central Todo & Activity log +:navtitle: 2026-03 +:page-layout: article + +== Summary + +Moved org-wide roadmap and activity log into the docs repository for the aggregated site (docs.devcentr.org). Added xref:where-docs-live.adoc[Where documentation lives] to explain cross-repo structure. + +== Affected codepaths + +* xref:todo-roadmap.adoc[Todo & Roadmap] +* xref:activity-log.adoc[Activity log] +* xref:where-docs-live.adoc[Where documentation lives] diff --git a/docs/modules/ROOT/pages/changelog-details/2026-07-fixnow-dev-hub.adoc b/docs/modules/ROOT/pages/changelog-details/2026-07-fixnow-dev-hub.adoc new file mode 100644 index 0000000..3c7737d --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2026-07-fixnow-dev-hub.adoc @@ -0,0 +1,12 @@ += 2026-07 — Register fixnow-dev in docs hub +:navtitle: 2026-07 +:page-layout: article + +== Summary + +Added fixnow-dev as an Antora content source and portal stub. FixNow docs cover pressure-driven issue tracking, AI value scoring, and resolution verification. + +== Affected codepaths + +* `antora-playbook.yml` — `dev-centr/fixnow-dev` content source +* xref:tools/fixnow-dev.adoc[FixNow portal stub] diff --git a/docs/modules/ROOT/pages/changelog-details/2026-08-07-valentus-head-meta-sync.adoc b/docs/modules/ROOT/pages/changelog-details/2026-08-07-valentus-head-meta-sync.adoc new file mode 100644 index 0000000..2d1eeda --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2026-08-07-valentus-head-meta-sync.adoc @@ -0,0 +1,12 @@ += 2026-08-07 — Valentus head-meta sync +:navtitle: 2026-08-07 +:page-layout: article + +== Summary + +Restored font-size FOUC prevention and `site-font-size.css` in the supplemental `head-meta.hbs` overlay. Condensed A/A/A control hides on desktop again; doc text scales on mobile. + +== Affected codepaths + +* `supplemental-ui/partials/head-meta.hbs` +* Playbooks pin rolling valentus-theme `v2` UI bundle diff --git a/docs/modules/ROOT/pages/changelog-details/2026-08-07-wire-issue-tracker.adoc b/docs/modules/ROOT/pages/changelog-details/2026-08-07-wire-issue-tracker.adoc new file mode 100644 index 0000000..ffb048e --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2026-08-07-wire-issue-tracker.adoc @@ -0,0 +1,12 @@ += 2026-08-07 — Wire issue-tracker into hub +:navtitle: 2026-08-07 +:page-layout: article + +== Summary + +Initial registration of the issue-tracker Antora component (later renamed to issues-browser). Documented Antora single-site policy for aggregated docs. + +== Affected codepaths + +* `antora-playbook.yml` content sources +* `docs/modules/ROOT/pages/tools/issue-tracker.adoc` (superseded by issues-browser stub in August 2026) diff --git a/docs/modules/ROOT/pages/changelog-details/2026-08-08-wire-agent-rules-ver-issues-browser.adoc b/docs/modules/ROOT/pages/changelog-details/2026-08-08-wire-agent-rules-ver-issues-browser.adoc new file mode 100644 index 0000000..93d225f --- /dev/null +++ b/docs/modules/ROOT/pages/changelog-details/2026-08-08-wire-agent-rules-ver-issues-browser.adoc @@ -0,0 +1,45 @@ += 2026-08-08 — Wire agent-rules, ver, and issues-browser +:navtitle: 2026-08-08 +:page-layout: article +:description: Register three Antora components and portal stubs; rename issue-tracker to issues-browser. + +== Summary + +The docs hub now aggregates three additional repositories and updates the former issue-tracker integration to the renamed **issues-browser** project. + +== Changes + +=== Antora playbooks + +All three playbooks (`antora-playbook.yml`, `antora-playbook-local.yml`, `antora-playbook.testing.yml`): + +* Replaced `issue-tracker` content source with `issues-browser`. +* Added `agent-rules` and `ver` content sources (`start_path: docs`). + +=== Portal pages + +New tool stubs under `docs/modules/ROOT/pages/tools/`: + +* xref:tools/agent-rules.adoc[Agent Rules] — modular agent rules assembly (`RULES.md`, `general/`, `profiles/`). +* xref:tools/ver.adoc[Ver] — universal VCS library, CLI, and optional Qt GUI. +* xref:tools/issues-browser.adoc[Issues Browser] — forge metadata backup with GUI/CLI/daemon/tray. + +xref:tools/issue-tracker.adoc[Issue Tracker] is now a redirect stub pointing at Issues Browser. + +=== Navigation + +* xref:tools/index.adoc[Tools index] lists the three new tools under Original Contributions. +* Sidebar nav adds Agent Rules, Ver, Issues Browser, and keeps Issue Tracker (renamed) for bookmark compatibility. + +== Affected codepaths + +* CI production build (`pnpm run build:online` / `.github/workflows/deploy.yml`) fetches component docs from the three new GitHub repos. +* Local sibling builds expect `../issues-browser`, `../agent-rules`, and `../ver` beside the playbook checkout. + +== Component verification + +Remote `docs/antora.yml` names match portal xrefs: + +* `agent-rules` → `xref:agent-rules::index.adoc` +* `ver` → `xref:ver::index.adoc` +* `issues-browser` → `xref:issues-browser::index.adoc` diff --git a/docs/modules/ROOT/pages/changelog.adoc b/docs/modules/ROOT/pages/changelog.adoc new file mode 100644 index 0000000..c8aa9ed --- /dev/null +++ b/docs/modules/ROOT/pages/changelog.adoc @@ -0,0 +1,19 @@ += Changelog +:navtitle: Changelog +:description: Functional changes to the Dev-Centr documentation hub and playbook. + +Release history for the **docs** playbook repository. Each entry links to a detail page with context and affected codepaths. + +== 2026 + +* link:changelog-details/2026-08-08-wire-agent-rules-ver-issues-browser.adoc[2026-08-08] — Wire agent-rules, ver, and issues-browser into Antora playbooks and tools hub. +* link:changelog-details/2026-08-07-valentus-head-meta-sync.adoc[2026-08-07] — Sync valentus head-meta font-size and topic docs. +* link:changelog-details/2026-08-07-wire-issue-tracker.adoc[2026-08-07] — Wire issue-tracker into hub; note Antora single-site policy. +* link:changelog-details/2026-07-fixnow-dev-hub.adoc[2026-07] — Register fixnow-dev in the Antora docs hub. +* link:changelog-details/2026-03-central-todo-activity-log.adoc[2026-03] — Central Todo & Roadmap and Activity log in docs repo. + +== 2025 + +* link:changelog-details/2025-03-lunr-search.adoc[2025-03] — Add Lunr full-text search to the documentation site. + +For day-to-day project updates across all repos, see xref:activity-log.adoc[Activity log].