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
2 changes: 2 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -12,3 +12,5 @@ node_modules/
*:Zone.Identifier
website/public/CONTRIBUTING.html
website/public/CONTRIBUTING.de.html
website/public/CONTRIBUTING.toc.html
website/public/CONTRIBUTING.de.toc.html
4 changes: 2 additions & 2 deletions CONTRIBUTING.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Semantic anchors are well-defined terms, methodologies, and frameworks that serv

== Artifact Types: Anchor, Contract, Skill

The catalog ships three artifact types. Knowing which one you are proposing decides where your contribution belongs. The full rationale lives in link:docs/specs/adrs/adr-007-artifact-taxonomy.adoc[ADR-007]; the working definitions are here.
The catalog ships three artifact types. Knowing which one you are proposing decides where your contribution belongs. The full rationale lives in link:https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/specs/adrs/adr-007-artifact-taxonomy.adoc[ADR-007]; the working definitions are here.

[cols="1,2,2,1", options="header"]
|===
Expand Down Expand Up @@ -100,7 +100,7 @@ Recognition is not activation. A model can talk fluently *about* a term while na

A term that passes the four Quality Criteria but fails the viability test is a *Contract*, not an Anchor.

*This gate is topic-neutral.* No subject area is privileged or banned — personality and assessment frameworks (MBTI, DISC, Big Five, HEXACO) are neither excluded for their topic nor admitted for being well-known. They must clear the same Viability Test as any other candidate, and — given their contested empirical standing — carry a `== Criticism` / `== Current Status` section. The rationale is in link:docs/specs/adrs/adr-008-personality-assessment-anchors.adoc[ADR-008].
*This gate is topic-neutral.* No subject area is privileged or banned — personality and assessment frameworks (MBTI, DISC, Big Five, HEXACO) are neither excluded for their topic nor admitted for being well-known. They must clear the same Viability Test as any other candidate, and — given their contested empirical standing — carry a `== Criticism` / `== Current Status` section. The rationale is in link:https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/specs/adrs/adr-008-personality-assessment-anchors.adoc[ADR-008].

== Developer Setup

Expand Down
6 changes: 3 additions & 3 deletions docs/CONTRIBUTING.de.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -12,7 +12,7 @@ Semantic Anchors (semantische Anker) sind klar definierte Begriffe, Methodologie

== Artefakttypen: Anchor, Contract, Skill

Der Katalog kennt drei Artefakttypen. Welchen Sie vorschlagen, entscheidet, wohin Ihr Beitrag gehört. Die vollständige Begründung steht in link:specs/adrs/adr-007-artifact-taxonomy.adoc[ADR-007]; die Arbeitsdefinitionen stehen hier.
Der Katalog kennt drei Artefakttypen. Welchen Sie vorschlagen, entscheidet, wohin Ihr Beitrag gehört. Die vollständige Begründung steht in link:https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/specs/adrs/adr-007-artifact-taxonomy.adoc[ADR-007]; die Arbeitsdefinitionen stehen hier.

[cols="1,2,2,1", options="header"]
|===
Expand Down Expand Up @@ -98,7 +98,7 @@ Erkennung ist nicht Aktivierung. Ein Modell kann flüssig *über* einen Begriff

Ein Term, der die vier Qualitätskriterien besteht, aber den Viability-Test nicht, ist ein *Contract*, kein Anchor.

*Dieses Gate ist themenneutral.* Kein Themengebiet ist bevorzugt oder verboten — Persönlichkeits- und Assessment-Modelle (MBTI, DISC, Big Five, HEXACO) werden weder wegen ihres Themas ausgeschlossen noch wegen ihrer Bekanntheit aufgenommen. Sie müssen denselben Viability-Test bestehen wie jeder andere Kandidat und — angesichts ihrer umstrittenen empirischen Absicherung — einen `== Criticism` / `== Current Status`-Abschnitt tragen. Die Begründung steht in link:specs/adrs/adr-008-personality-assessment-anchors.adoc[ADR-008].
*Dieses Gate ist themenneutral.* Kein Themengebiet ist bevorzugt oder verboten — Persönlichkeits- und Assessment-Modelle (MBTI, DISC, Big Five, HEXACO) werden weder wegen ihres Themas ausgeschlossen noch wegen ihrer Bekanntheit aufgenommen. Sie müssen denselben Viability-Test bestehen wie jeder andere Kandidat und — angesichts ihrer umstrittenen empirischen Absicherung — einen `== Criticism` / `== Current Status`-Abschnitt tragen. Die Begründung steht in link:https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/specs/adrs/adr-008-personality-assessment-anchors.adoc[ADR-008].

== Wie man einen neuen Anker vorschlägt

Expand Down Expand Up @@ -214,7 +214,7 @@ Siehe die Website für vollständige Kategorienbeschreibungen.

Anker sind mit beruflichen Rollen getaggt, um relevante Inhalte zu filtern. Verwenden Sie die *Rollen-ID* (kebab-case) im `:roles:` Metadaten-Attribut.

Siehe link:roles/[docs/roles/] für ausführliche Rollenbeschreibungen (EN + DE).
Siehe link:https://github.com/LLM-Coding/Semantic-Anchors/blob/main/docs/roles[docs/roles/] für ausführliche Rollenbeschreibungen (EN + DE).

=== Operative Fachliche Rollen

Expand Down
6 changes: 6 additions & 0 deletions docs/changelog.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,12 @@

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

== 2026-07-24

*Fix — the German Contributing page was rendered from an orphaned source:*

* The `/de/contributing` page was built from `website/public/CONTRIBUTING.de.adoc`, but every contributor edit since #603 went into `docs/CONTRIBUTING.de.adoc` — the file that sits next to its English sibling and looks maintained. Nothing rendered it. German readers therefore never saw the artifact taxonomy (#585), the Viability Test (#640), the ADR-008 topic-neutral gate, the issue-title convention (#564), or the developer setup, PR review policy and Criticism/Current-Status rules added in #695. `render-docs.js` now renders `docs/CONTRIBUTING.de.adoc`, and the stale copy under `website/public/` is deleted, so there is one German source again. Also fixed five relative `link:` targets in both Contributing files (ADR-007, ADR-008, `docs/roles/`) that resolved against the served route and 404'd — they now point at absolute GitHub URLs, which work on the website and in GitHub's rendered view alike.

== 2026-07-08

*Fix — EN/DE metadata parity:*
Expand Down
8 changes: 5 additions & 3 deletions scripts/render-docs.js
Original file line number Diff line number Diff line change
Expand Up @@ -149,10 +149,12 @@ renderFile(path.join(ROOT, 'docs/about.adoc'), path.join(WEB_DOCS, 'about.html')
renderFile(path.join(ROOT, 'docs/about.de.adoc'), path.join(WEB_DOCS, 'about.de.html'))

renderFile(path.join(ROOT, 'CONTRIBUTING.adoc'), path.join(WEB_PUBLIC, 'CONTRIBUTING.html'))
// The German CONTRIBUTING source lives only in website/public/ (served raw to
// the SPA); render it from there so the /de/contributing page can be built.
// The German CONTRIBUTING source is docs/CONTRIBUTING.de.adoc — the file
// contributors actually maintain. It is the translation counterpart of the
// root CONTRIBUTING.adoc, so both sources sit next to their siblings in the
// repo rather than in the build output directory.
renderFile(
path.join(WEB_PUBLIC, 'CONTRIBUTING.de.adoc'),
path.join(ROOT, 'docs/CONTRIBUTING.de.adoc'),
path.join(WEB_PUBLIC, 'CONTRIBUTING.de.html')
)

Expand Down
216 changes: 0 additions & 216 deletions website/public/CONTRIBUTING.de.adoc

This file was deleted.

Loading