Skip to content
Draft
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 6 additions & 1 deletion README.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,6 +12,9 @@ ifdef::env-github[]
<a href="https://github.com/dev-centr/docs/stargazers"><img src="https://img.shields.io/github/stars/dev-centr/docs.svg?style=for-the-badge" alt="Stars"></a>
<a href="https://github.com/dev-centr/docs/issues"><img src="https://img.shields.io/github/issues/dev-centr/docs.svg?style=for-the-badge" alt="Issues"></a>
<br />
<a href="https://docs.devcentr.org"><img src="https://img.shields.io/badge/docs-Dev--Centr-22c55e?style=for-the-badge" alt="Docs"></a>
<a href="https://github.com/dev-centr/docs/actions/workflows/deploy.yml"><img src="https://github.com/dev-centr/docs/actions/workflows/deploy.yml/badge.svg?style=for-the-badge" alt="Deploy"></a>
<br />
<h3 align="center">Dev-Centr Documentation</h3>
<p align="center">
Dev-Centr documentation hub. Antora site aggregating dev-centr projects.<br />
Expand All @@ -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

Expand All @@ -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.
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/nav.adoc
Original file line number Diff line number Diff line change
@@ -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
Expand Down
1 change: 1 addition & 0 deletions docs/modules/ROOT/pages/activity-log.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.
Expand Down
12 changes: 12 additions & 0 deletions docs/modules/ROOT/pages/changelog-details/2025-03-lunr-search.adoc
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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]
Original file line number Diff line number Diff line change
@@ -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]
Original file line number Diff line number Diff line change
@@ -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
Original file line number Diff line number Diff line change
@@ -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)
Original file line number Diff line number Diff line change
@@ -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`
19 changes: 19 additions & 0 deletions docs/modules/ROOT/pages/changelog.adoc
Original file line number Diff line number Diff line change
@@ -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].
4 changes: 3 additions & 1 deletion docs/modules/ROOT/pages/where-docs-live.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -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.

Expand Down