7. hét · az ötödik dimenzió

Dokumentáció: úgy írni, hogy a gépek megértsenek

Az eredmény-dimenziók azt írták le, mit mond rólad az AI. A gépezet-dimenziók azt, hogyan változtatod meg — a szavakkal kezdve, amelyeket egy modell valóban olvas.

Makefield · Berlin

Az átkelés

Attól, amit az AI mond, ahhoz, ahogy megváltoztatod

Az első négy dimenzió az eredményt írta le — felismer-e az AI, pontosan leír-e, méltányosan keretez-e és ajánl-e. A következő három a mögöttes gépezet: azok a dolgok, amelyeken valóban dolgozol, hogy ezt az eredményt mozgasd. Az első gépezet-darab a legközvetlenebb, mert az a rész, amit teljesen irányítasz — a saját dokumentációd, a szavak, amelyeket egy modell olvas, amikor téged próbál leírni.

A gépek nem úgy olvasnak, mint az emberek

Feldarabolva, kinyerve, összefoglalva

Egy LLM nem úgy olvassa a termékoldaladat, ahogy egy ember átfutja. Darabokra bontja a szöveget, kihúzza az entitásokat és állításokat, és azokból épít összefoglalót — ahogy az AI-válaszok felépítésénél láttuk. Ez megváltoztatja, mit jelent a „jó tartalom". A próza, amit egy ember meggyőzésére írtak — hosszú elbeszélő bekezdések, feltételezett kontextus, marketingnyelv —, gyakran homályos vagy téves AI-összefoglalót eredményez, mert a modell nem tudja tisztán kinyerni a szükséges konkrét tényeket. A lekérésre írt tartalom pontosakat eredményez.

Hogyan néz ki a jó

Tények, amelyeket egy modell tisztán felemel

A dokumentáció, amelyet egy AI jól kezel, általában közös alakot mutat: minden kulcsoldal világosan kimondja, mi a termék és kinek; a konkrét állításokat — egy ársáv, egy integráció, egy megkülönböztető jegy — explicit, önmagukban álló mondatként írják, nem egy bekezdésbe temetve; és a gyakori kérdéseket közvetlenül válaszolják meg, azon a nyelven, amit egy vásárló használna. A teszt egyszerű: végy három-öt konkrét tényt magadról, és nézd meg, pontosan lekéri-e mindegyiket az AI. Ha a tény helyett generikus összefoglalót ad vissza, a dokumentáció még nem kinyerhető.

Hogyan néz ki a kudarc

A brosúra-probléma

A gyakori kudarc az átfutásra, nem a lekérésre optimalizált dokumentáció: elbeszélő marketingszöveg, kulcstények inkább sugallva, mint kimondva, sehol közvetlen kérdés-válasz. A tünet egy generikus AI-leírás rólad — lényegében ugyanaz, amit bármely versenytársadról írna a kategóriádban —, vagy olyan, amely csendben egy elavult vagy téves tényt hordoz, amelyet nem tudott korrigálni, mert a helyes tényt sosem mondták ki tisztán.

Miért itt kezdd

A legolcsóbb kar, amit irányítasz

A dokumentációnál kell a gépezet-munkának kezdődnie, egy okból: ez az egyetlen rész, ami teljesen a kezedben van. Nem irányítod, mit mond rólad a Reddit, vagy melyik forrásokban bízik egy motor — de teljesen irányítod, hogy a saját oldalaid kimondják-e a tényeidet olyan formában, amit egy modell felemelhet. Ez a legolcsóbb, leggyorsabb elérhető korrekció, és az alap, amelyre a következő két dimenzió épül.

Ezután — Strukturált adatok: a tényeidet gép-igazzá tenni sémával, és miért nem elég önmagában a séma. Új vagy itt? Kezdd az áttekintéssel.