Sikertörténet · Telekommunikációs technológia
Több tízezer oldal DITA-ból AsciiDocba
Egy telekommunikációs technológiai vállalat teljes dokumentációs könyvtárát költöztettük DITA formátumból docs-as-code eszközláncba — többéves átfutás és minőségromlás nélkül.
- konvertált oldal
- Több tízezer
- egységes forrásformátum
- DITA → AsciiDoc
- szakértő által ellenőrizve
- 100%
Kihívás
Ekkora volumenhez az AI már nem extra, hanem alap
A DITA-alapú könyvtár hosszú évek alatt nőtt ekkorára: mély témastruktúrák, feltételes profilozás, több ezer kereszthivatkozás és számos következetlen jelölés halmozódott fel benne. A kézi konverzió nem jöhetett szóba, egy egyszerű szkript pedig túl sok hibás hivatkozást és rosszul formázott táblázatot hagyott volna hátra.
Megközelítés
Szkriptek és AI segítik a munkát, szakemberek döntenek
Használt eszközök
- 01
Elemeztük a DITA-forrást, besoroltuk a tartalmi mintákat, és felmértük, hol működik megbízhatóan az automatizált konverzió, illetve hol tudna hibázni.
- 02
Automatizált DITA–AsciiDoc konverziós pipeline-t építettünk, megőrizve a struktúrát, a feltételes tartalmakat és a kereszthivatkozásokat.
- 03
LLM-ek segítségével javítottuk, amivel a szkriptek nem boldogultak: a szabálytalan táblázatokat, az elcsúszott soron belüli jelöléseket és a következetlen terminológiát.
- 04
Mielőtt az új Git repositoryba került, minden konvertált oldalt szövegíró ellenőrzött egy rögzített szempontrendszer alapján.
- 05
Beállítottuk az AsciiDoc buildet és a CI publikációs pipeline-t, majd betanítottuk a belső csapatot az új munkafolyamatra.
Eredmény
Az új rendszer elkészült, az addigi csapat átvette
A teljes könyvtár egyszerű szöveges AsciiDoc formátumba és verziókezelés alá került. Automatikusan publikálható, és a mérnökök, valamint a szövegírók egyaránt szerkeszthetik. Az automatizált konverzió, az AI-támogatott javítás és a szakértői ellenőrzés együtt a kézi megoldás idejének töredékére rövidítette a migrációt.
Következő: 40+ oktatási modul →