Teadmusbaasi vaikne lagunemine
Teadmusbaasid ei lagune ülepäev. Nad lagunevad aeglaselt. Kaheksa kuud tagasi kirjutatud artikkel viitab endiselt vanale seadete lehele. Ühes juhendis mainitakse funktsiooni, mis nimetati märtsis ümber. Kolm erinevat artiklit selgitavad sama mõistet kolme erineva terminiga. Keegi ei märka, kuni tuleb klienditoe pilet, mis ütleb "järgisin juhiseid, aga seda nuppu ei eksisteeri."
Kui teadmusbaasis on 20 artiklit, saad kõik üle lugeda ühe päevalõunaga. Kui neid on 150, muutub käsiaudit omaette projektiks. Enamik meeskondi lükkab seda edasi, kuni midagi nähtavalt katki läheb. Selleks ajaks on triiv kuhjunud ja parandamine võtab nädalaid.
Agent, mis auditeerib kogu kausta
Ritemark käsitleb sinu teadmusbaasi kui kausta markdown-faile sinu masinas. AI agent terminalis saab lugeda iga faili selles kaustas. Mitte ühte korraga. Kõiki korraga.
Ava oma teadmusbaasi projekt Ritemarkis. Sul on 120 artiklit kategooriates nagu alustamine, arveldamine, integratsioonid ja veaotsing. Käivita agent ja ütle: "Loe läbi iga artikkel selles teadmusbaasis. Tuvasta artiklid, mis viitavad kasutajaliidese elementidele, funktsioonide nimedele või töövooludele, mis võivad olla aegunud. Märgi ebajärjekindel terminoloogia. Loetle ristviited, mis viitavad artiklitele, mida ei eksisteeri."
Agent töötab kausta süstemaatiliselt läbi. Ta loeb iga faili, ehitab arusaamise sinu terminoloogiamustritest ja kontrollib viiteid. Mõne minuti pärast saad raporti. Mitte ebamäärast kokkuvõtet, vaid konkreetsed leiud: "billing-overview.md viitab nimele 'Plan Settings', aga integrations-setup.md kasutab nime 'Subscription Management'. Seitse artiklit viitavad failile getting-started-v2.md, mida selles kaustas ei eksisteeri."
Kvartaalne audit praktikas
Dokumentatsiooni juht arendustööriistade ettevõttes tegi selle auditi 140 artikliga teadmusbaasil. Ta oli kuude kaupa kavatsenud täielikku ülevaatust teha, aga lükkas seda pidevalt edasi.
Ta avas teadmusbaasi kausta Ritemarkis ja palus agendil skaneerida kolme asja: aegunud kasutajaliidese viited, terminoloogia ebajärjekindlused ja katkised sisemised lingid.
Agent leidis 23 artiklit, mis viitasid vanadele funktsioonide nimedele, 8 terminoloogia ebajärjekindlust (sama API võtme loomise protsessi nimetati erinevates artiklites "genereerimine," "loomine" ja "seadistamine") ning 5 katkist ristviit. Ta esitas leiud struktureeritud raportina uude markdown-faili.
Dokumentatsiooni juht vaatas raporti kahe päevaga läbi, parandades iga probleemi. Mõned olid kiired otsi-ja-asenda tööd. Teised vajasid sektsioonide ümberkirjutamist. Aga terviklik nimekiri tähendas, et ta sai prioritiseerida ja edenemist jälgida. Ükski artikkel ei jäänud kahe silma vahele, sest see oli alamkaustas, mida ta unustas kontrollida.
Vahe ühe faili ja kõigi failide vahel
Enamik AI kirjutamistööristu töötab sellega, mille sa neile kleebid. Üks artikkel korraga. See sobib üksikute artiklite kirjutamiseks ja redigeerimiseks. Aga teadmusbaasi hooldamine on põhimõtteliselt artiklitevaheliste suhete küsimus. Järjekindel terminoloogia kogu kogumis. Kehtivad ristviited. Ühtne struktuur.
Ritemarki agent loeb kogu sinu dokumentatsioonikausta. Ta suudab märkata mustreid ja ebajärjekindlusi, mis muutuvad nähtavaks ainult siis, kui vaatad kõike koos. Üksik artikkel võib iseseisvalt korras välja näha. Probleem ilmneb alles siis, kui võrdled seda 119 teisega.