Skip to content

feat: add changelog page to website #154

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
rdmueller merged 2 commits into from
Mar 9, 2026
Merged

feat: add changelog page to website #154

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d11b81a
feat: add changelog page to website with contributor credits
raifdmueller Mar 9, 2026
e9621ea
fix: update E2E tests for new header layout
raifdmueller Mar 9, 2026
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
158 changes: 158 additions & 0 deletions docs/changelog.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -0,0 +1,158 @@
= Changelog
:toc:
:toc-placement: preamble
:toclevels: 2

A chronological record of all semantic anchors added to the catalog. Community contributors are credited with thanks.

== 2026-03-09

* *CQRS* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/137[#137]. Thank you!
* *GoF Design Patterns* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/140[#140]. Thank you!
* *Test Double (Meszaros)* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/142[#142]. Thank you!
* *Event-Driven Architecture* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/143[#143]. Thank you!
* *BDD (Given-When-Then)* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/138[#138], merged via https://github.com/LLM-Coding/Semantic-Anchors/pull/152[#152]. Thank you!
* *YAGNI* — contributed by https://github.com/Nantero1[@Nantero1] in https://github.com/LLM-Coding/Semantic-Anchors/pull/139[#139], merged via https://github.com/LLM-Coding/Semantic-Anchors/pull/152[#152]. Thank you!

== 2026-03-06

* *ATAM* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/133[#133]
* *LASR* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/135[#135]

== 2026-03-04

* *OWASP Top 10* — proposed by https://github.com/Advisior[@Advisior] in https://github.com/LLM-Coding/Semantic-Anchors/issues/130[#130]. Thank you!

== 2026-03-01

* *GoM (Grundsätze ordnungsmäßiger Modellierung)* — proposed by https://github.com/raifdmueller[@raifdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/126[#126]

== 2026-02-23

* *Regulated Environment* — proposed by https://github.com/bit-jkraushaar[@bit-jkraushaar] in https://github.com/LLM-Coding/Semantic-Anchors/issues/120[#120]. Thank you!

== 2026-02-22

* *MoSCoW* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/115[#115]

== 2026-02-17

* *Chatham House Rule* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/101[#101]

== 2026-02-16

* *Fowler Patterns (PEAA)* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/99[#99]

== 2026-02-13

* *Morphological Box* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/67[#67]
* *IEC 61508 SIL Levels* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/67[#67]
* Split from monolithic README.adoc into individual anchor files (https://github.com/LLM-Coding/Semantic-Anchors/pull/38[#38])

== 2026-02-12

* *Socratic Method* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *BLUF* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *Rubber Duck Debugging* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *Chain of Thought* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *Devil's Advocate* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *Five Whys* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *Feynman Technique* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/31[#31]
* *MADR* — proposed by https://github.com/raifdmueller[@raifdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/29[#29]

== 2026-02-11

* *TIMTOWTDI* — contributed by https://github.com/rehsack[@rehsack] in https://github.com/LLM-Coding/Semantic-Anchors/pull/28[#28]. Thank you!

== 2026-02-07

* *MECE Principle* — proposed by https://github.com/ingo-eichhorst[@ingo-eichhorst] in https://github.com/LLM-Coding/Semantic-Anchors/issues/26[#26]. Thank you!

== 2026-02-05

* *Nelson Rules* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/20[#20]
* *Control Chart (Shewhart)* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/21[#21]
* *SPC* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/22[#22]

== 2026-02-03

* *DRY Principle* — added in https://github.com/LLM-Coding/Semantic-Anchors/pull/19[#19]
* *SPOT Principle* — added in https://github.com/LLM-Coding/Semantic-Anchors/pull/19[#19]
* *SSOT Principle* — added in https://github.com/LLM-Coding/Semantic-Anchors/pull/19[#19]
* *SOTA* — proposed by https://github.com/raifdmueller[@raifdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/16[#16]
* *todo.txt-flavoured Markdown* — proposed by https://github.com/raifdmueller[@raifdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/14[#14]

== 2026-01-21

* *Pyramid Principle* — proposed by https://github.com/rdmueller[@rdmueller] in https://github.com/LLM-Coding/Semantic-Anchors/issues/12[#12]

== 2025-11-18

* *Mutation Testing* — contributed by ThomasPeuss. Thank you!

== 2025-11-13

* *BEM Methodology* — contributed by Robert Nimax. Thank you!

== 2025-11-11

* *Conventional Commits* — contributed by https://github.com/rehsack[@rehsack] in https://github.com/LLM-Coding/Semantic-Anchors/pull/4[#4]. Thank you!
* *Semantic Versioning* — contributed by https://github.com/rehsack[@rehsack] in https://github.com/LLM-Coding/Semantic-Anchors/pull/4[#4]. Thank you!
* *SOLID Principles* — contributed by https://github.com/bit-jkraushaar[@bit-jkraushaar]. Thank you!

== 2025-11-10 — Initial Catalog

First commit by https://github.com/rdmueller[@rdmueller] with 23 founding anchors:

* *TDD, London School*
* *TDD, Chicago School*
* *Problem Space NVC*
* *Mental Model (Naur)*
* *EARS Requirements*
* *arc42*
* *ADR (Nygard)*
* *Pugh Matrix*
* *C4 Diagrams*
* *Docs-as-Code*
* *Domain-Driven Design*
* *Hexagonal Architecture*
* *Clean Architecture*
* *User Story Mapping*
* *Impact Mapping*
* *Jobs To Be Done*
* *Cynefin Framework*
* *Wardley Mapping*
* *Property-Based Testing*
* *Testing Pyramid*
* *Diátaxis Framework*
* *What Qualifies as a Semantic Anchor*

== Community Contributors

Thank you to everyone who has contributed anchors to the catalog!

[cols="1,3"]
|===
| Contributor | Contributions

| https://github.com/rehsack[@rehsack]
| Conventional Commits, Semantic Versioning, TIMTOWTDI

| https://github.com/bit-jkraushaar[@bit-jkraushaar]
| SOLID Principles, Regulated Environment

| Robert Nimax
| BEM Methodology

| ThomasPeuss
| Mutation Testing

| https://github.com/ingo-eichhorst[@ingo-eichhorst]
| MECE Principle

| https://github.com/Advisior[@Advisior]
| OWASP Top 10

| https://github.com/Nantero1[@Nantero1]
| CQRS, GoF Design Patterns, Test Double (Meszaros), Event-Driven Architecture, BDD, YAGNI
|===
2 changes: 2 additions & 0 deletions website/src/components/header.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -37,6 +37,7 @@ export function renderHeader() {
<a href="#/" class="nav-link text-[var(--color-text-secondary)] hover:text-[var(--color-text)] transition-colors" data-route="/" data-i18n="nav.catalog">${i18n.t('nav.catalog')}</a>
<a href="#/about" class="nav-link text-[var(--color-text-secondary)] hover:text-[var(--color-text)] transition-colors" data-route="/about" data-i18n="nav.about">${i18n.t('nav.about')}</a>
<a href="#/contributing" class="nav-link text-[var(--color-text-secondary)] hover:text-[var(--color-text)] transition-colors" data-route="/contributing" data-i18n="nav.contributing">${i18n.t('nav.contributing')}</a>
<a href="#/changelog" class="nav-link text-[var(--color-text-secondary)] hover:text-[var(--color-text)] transition-colors" data-route="/changelog" data-i18n="nav.changelog">${i18n.t('nav.changelog')}</a>
</div>
<div class="flex items-center gap-3">
<button
Expand Down Expand Up @@ -140,6 +141,7 @@ export function renderHeader() {
<a href="#/" class="nav-link mobile-nav-link px-3 py-2 rounded-md text-[var(--color-text-secondary)] hover:text-[var(--color-text)] hover:bg-[var(--color-bg-secondary)] transition-colors" data-route="/" data-i18n="nav.catalog">${i18n.t('nav.catalog')}</a>
<a href="#/about" class="nav-link mobile-nav-link px-3 py-2 rounded-md text-[var(--color-text-secondary)] hover:text-[var(--color-text)] hover:bg-[var(--color-bg-secondary)] transition-colors" data-route="/about" data-i18n="nav.about">${i18n.t('nav.about')}</a>
<a href="#/contributing" class="nav-link mobile-nav-link px-3 py-2 rounded-md text-[var(--color-text-secondary)] hover:text-[var(--color-text)] hover:bg-[var(--color-bg-secondary)] transition-colors" data-route="/contributing" data-i18n="nav.contributing">${i18n.t('nav.contributing')}</a>
<a href="#/changelog" class="nav-link mobile-nav-link px-3 py-2 rounded-md text-[var(--color-text-secondary)] hover:text-[var(--color-text)] hover:bg-[var(--color-bg-secondary)] transition-colors" data-route="/changelog" data-i18n="nav.changelog">${i18n.t('nav.changelog')}</a>
</div>
</div>
</nav>
Expand Down
12 changes: 12 additions & 0 deletions website/src/main.js
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,7 @@ function initApp() {
addRoute('/', renderHomePage)
addRoute('/about', renderAboutPage)
addRoute('/contributing', renderContributingPage)
addRoute('/changelog', renderChangelogPage)
addRoute('/all-anchors', renderAllAnchorsPage)

const app = document.querySelector('#app')
Expand Down Expand Up @@ -178,6 +179,15 @@ function renderContributingPage() {
loadDocContent('CONTRIBUTING.adoc')
}

function renderChangelogPage() {
const pageContent = document.getElementById('page-content')
if (!pageContent) return

pageContent.innerHTML = renderDocPage()
updateActiveNavLink()
loadDocContent('docs/changelog.adoc')
}
Comment on lines +182 to +189

@coderabbitai coderabbitai Bot Mar 9, 2026

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

⚠️ Potential issue | 🔴 Critical

🧩 Analysis chain

🏁 Script executed:

#!/bin/bash
# Prüfen, ob changelog.adoc im render-docs.js enthalten ist
echo "=== Suche nach changelog in render-docs.js ==="
rg -n "changelog" scripts/render-docs.js || echo "changelog nicht gefunden in render-docs.js"

echo ""
echo "=== Aktuelle renderFile Aufrufe ==="
rg -n "renderFile\(" scripts/render-docs.js

Repository: LLM-Coding/Semantic-Anchors

Length of output: 712

🏁 Script executed:

#!/bin/bash
echo "=== Suche nach renderChangelogPage ==="
rg -n "renderChangelogPage" website/src/main.js | head -20

echo ""
echo "=== Suche nach loadDocContent Implementierung ==="
rg -n "function loadDocContent" website/src/ -A 5

echo ""
echo "=== Prüfen auf docs/changelog.adoc ==="
find . -name "*changelog*" -type f | grep -E "\.(adoc|html)$" || echo "Keine changelog-Dateien gefunden"

echo ""
echo "=== Prüfen auf addRoute('/changelog') ==="
rg -n "addRoute.*changelog" website/src/main.js

Repository: LLM-Coding/Semantic-Anchors

Length of output: 859

Kritisch: docs/changelog.html wird nicht im Build-Prozess generiert.

Die Funktion renderChangelogPage (Zeile 182) ruft loadDocContent('docs/changelog.adoc') auf, die dies in docs/changelog.html konvertiert und abruft. Die Route ist registriert (Zeile 105), und die Quelldatei docs/changelog.adoc existiert. Allerdings fehlt in scripts/render-docs.js der entsprechende renderFile-Aufruf – nur about.adoc, CONTRIBUTING.adoc und all-anchors.adoc werden gerendert. Dies führt zu einem 404-Fehler beim Aufrufen der /changelog-Route.

Fügen Sie in scripts/render-docs.js die fehlenden renderFile-Aufrufe hinzu:

renderFile(path.join(ROOT, 'docs/changelog.adoc'), path.join(WEB_DOCS, 'changelog.html'))
renderFile(path.join(ROOT, 'docs/changelog.de.adoc'), path.join(WEB_DOCS, 'changelog.de.html'))
🤖 Prompt for AI Agents 
Verify each finding against the current code and only fix it if needed.

In `@website/src/main.js` around lines 182 - 189, The changelog HTML isn't
generated because the build script (render-docs.js) only calls renderFile for
about.adoc, CONTRIBUTING.adoc and all-anchors.adoc; add two renderFile calls to
render the changelog sources so loadDocContent('docs/changelog.adoc') used by
renderChangelogPage can fetch the generated file: add renderFile(path.join(ROOT,
'docs/changelog.adoc'), path.join(WEB_DOCS, 'changelog.html')) and
renderFile(path.join(ROOT, 'docs/changelog.de.adoc'), path.join(WEB_DOCS,
'changelog.de.html')) to the list of renderFile invocations in render-docs.js
(and ensure the build task that runs render-docs.js includes these new outputs).


function renderAllAnchorsPage() {
const pageContent = document.getElementById('page-content')
if (!pageContent) return
Expand Down Expand Up @@ -381,6 +391,8 @@ function handleLanguageChange() {
loadDocContent('docs/about.adoc')
} else if (currentRoute === '/contributing') {
loadDocContent('CONTRIBUTING.adoc')
} else if (currentRoute === '/changelog') {
loadDocContent('docs/changelog.adoc')
} else if (currentRoute === '/all-anchors') {
loadDocContent('docs/all-anchors.adoc')
} else if (currentRoute === '/') {
Expand Down
1 change: 1 addition & 0 deletions website/src/translations/de.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
"nav.catalog": "Katalog",
"nav.about": "Über",
"nav.contributing": "Mitwirken",
"nav.changelog": "Änderungsprotokoll",
"main.heading": "Semantic Anchors erkunden",
"main.subheading": "Ein kuratierter Katalog klar definierter Begriffe, Methoden und Frameworks für effektive LLM-Kommunikation.",
"main.aboutLink": "Über",
Expand Down
1 change: 1 addition & 0 deletions website/src/translations/en.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,7 @@
"nav.catalog": "Catalog",
"nav.about": "About",
"nav.contributing": "Contributing",
"nav.changelog": "Changelog",
"main.heading": "Explore Semantic Anchors",
"main.subheading": "A curated catalog of well-defined terms, methodologies, and frameworks for effective LLM communication.",
"main.aboutLink": "About",
Expand Down
Loading
Loading