Skip to content
Merged
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
4 changes: 3 additions & 1 deletion DOCS/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -16,7 +16,9 @@ here goes stale, fix the routing, not by copying content into this file.

New or substantially-edited docs follow
[the OKF documentation standard](/DOCS/standards/okf-documentation.md)
(frontmatter + linking conventions).
(frontmatter + linking conventions). [`DOCS/log.md`](/DOCS/log.md)
records documentation-standard-relevant history — new ADRs, policy
changes, structural migrations.

## Decisions

Expand Down
24 changes: 24 additions & 0 deletions DOCS/log.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,24 @@
# Documentation Log

Reverse-chronological record of documentation-standard-relevant changes
across `DOCS/` — new ADRs, policy adoptions, and structural migrations.
Routine content edits are tracked by `git log`, not here; this file is
for changes that affect how the knowledge base itself is organized or
governed.

## 2026-08-30

Adopted OKF v0.2 as the standing documentation standard. Added
`DOCS/standards/okf-documentation.md`; `CLAUDE.md` and `DOCS/index.md`
now point to it. New knowledge-bearing docs must comply going forward;
legacy docs migrate opportunistically on substantial edit, not in bulk.
See [issue #75](https://github.com/sankar-ramamoorthy/rag-foundry-universal/issues/75) /
[PR #76](https://github.com/sankar-ramamoorthy/rag-foundry-universal/pull/76).

## 2026-08-27

Retrofitted `DOCS/adr/` and added `DOCS/index.md` using the frontmatter
+ `[[wikilink]]` pattern `DOCS/audit/` had already independently
established, generalizing it into the repo's first cross-directory
documentation convention. See
[PR #63](https://github.com/sankar-ramamoorthy/rag-foundry-universal/pull/63).
8 changes: 5 additions & 3 deletions DOCS/standards/okf-documentation.md
Original file line number Diff line number Diff line change
Expand Up @@ -71,9 +71,11 @@ The spec reserves two filenames at any level of the hierarchy, which

- **`index.md`** — directory listing / map-of-content. Already in use
(`DOCS/index.md`, `DOCS/audit/00-Audit-Overview.md`).
- **`log.md`** — chronological history of updates. Not currently used
anywhere in this repo; reserved here only so a future concept
document doesn't collide with it, not a requirement to create one.
- **`log.md`** — chronological history of updates. In use at
[`DOCS/log.md`](/DOCS/log.md): a reverse-chronological record of
documentation-standard-relevant changes (new ADRs, policy adoptions,
structural migrations) — not a substitute for `git log`, and not
meant to capture routine content edits.

## Scope

Expand Down
Loading