Komponenter

Den här sajten

En konsument av kontraktet, aldrig en källa till det. Den förklarar ramverket; den definierar det inte.

En konsument av kontraktet, aldrig en källa till det. Den förklarar ramverket; den definierar det inte.

Sidan du läser är en komponent, och den är deklarerad i samma kontrakt som alla andra delar. Det är mindre märkligt än det låter, och det åtgärdar något bestämt.

Beroendet går åt ett håll

Den här sajten läser ecosystem.yaml ur det publika repot. Ramverket vet inte att sajten finns, har ingen referens till den, och skulle vara opåverkat om den togs bort i morgon.

Att vända på det hade gjort ramverket beroende av en webbsida. Ett versionsnummer definierat av vad en sida råkade rendera, komponentbeskrivningar som bara fanns som säljtext, en kontroll som gick igenom för att sajten höll med sig själv. Riktningen är ingen preferens; det är vad som gör kontraktet värt att lita på.

Vilket är varför den här sidan kan säga vad den saknar

Åtta av nio komponenter har ännu ingen egen sida. Bygget vet det — det läser kontraktet, jämför mot vad som skrivits, och säger det i stället för att rendera ett övertygande urval.

En manual som bara visar det den blivit klar med är en manual man inte kan se är ofullständig.

Vad som renderas och vad som skrivs

Allt sakligt på en komponentsida — vad den läser, vad den skriver, vad den beror på, vilket repo som dokumenterar den — kommer ur kontraktet vid bygge. Prosan runtomkring är skriven här, eftersom kontraktet bär vad en komponent är och inte vad en läsare behöver för att förstå den.

Säger de två någonsin emot varandra har kontraktet rätt och den här sidan är en bugg.

Den här delen är publik

Sajten är publik. Dess källkod är det inte — vilket är värt att säga i stället för att lämna till upptäckt.

Deklarerat i kontraktet

Sort
public website
Roll
Explains the framework and how to install it
Läser
  • this file, fetched from the public repo
Skriver
inget
Beror på
  • this contract
Dokumentationen hör hemma i
core-skills

Att veta. A CONSUMER of the contract, never a source of it. The dependency runs contract -> site; inverting it would make the framework depend on a website

Citerat ur kontraktet, som är engelskt. Ett citat i original kan inte drifta från sin källa; en översättning här hade blivit en andra kopia att hålla sann.

Ur ecosystem.yaml, kontrakt 41 · core-skills 1.89.4 · läst vid bygge 2026-10-08