Radni primjer: Ova bilješka bilježi granicu pregleda definiranu za Content Pipeline v1; tretiraj je kao radni model dok je budući stvarni rad ne potvrdi.
Promjena Markdown sadržaja i promjena alata za objavu obje ulaze u Git, ali nisu ista vrsta promjene.
Za sadržaj je bitno sačuvati tekst kao Markdown, postojeći format frontmattera i stabilni id. Quartz ga pretvara u javni prikaz; ne postaje time source of truth. To je ista granica koju opisuje Everything Is a File.
Prije trajne promjene provjeri:
- Da su
id, naslov i postojećitypevaljani i jedinstveni. - Da novi wikilinkovi ciljaju stvarne dokumente. Nepoznati cilj treba prijaviti, ne popuniti praznom stranicom.
- Da
git diffigit statuspokazuju samo ono što se namjerava promijeniti. - Da content-only commit sadrži samo Markdown sadržaj i da nijedan još nepushani commit ne nosi kod, konfiguraciju ili deployment promjene.
Ova provjera razdvaja uređivanje znanja od promjene samog publishing alata. Git povijest i sadržaj dokumenta čuvaju provenance; model nema zasebno source polje.
Povezano: Dobar blog, Quartz i Everything Is a File.