INSENEERIATIIMIDELE

Dokumentatsioon, mis teab, millal sinu kood muutus.

Iga dokumentatsioonitööriist suudab artikli majutada. Ükski ei tea, millal liidetud PR selle just valeks muutis. Ellie Docs ühendub sinu GitHubi hoidlaga, jälgib koodi, millest iga artikkel tegelikult sõltub, ning märgib ja koostab parandi mustandi hetkel, kui artikkel aegub.

Alusta tasuta

Kaardita · Registreeru Google'i, Microsofti, GitHubi või e-postiga

MIKS DOKUMENTATSIOON AEGUB

Kellegi töö pole "märgata, et dokumentatsioon on vale".

API-s nimetatakse väli ümber. Lõpp-punkt tunnistatakse aegunuks. Kasutajaliidese voog kujundatakse ümber. PR liidetakse puhtalt, testid läbivad, ja vana käitumist kirjeldav abiartikkel jääb seisma: õige väljanägemisega, aga vaikselt vale, kuni klient või tugipilet selle välja toob.

🔗

Koodiga seotud artiklid

Iga artikli saab siduda koodi, lõpp-punktide või API spetsifikatsiooniga, mida see tegelikult dokumenteerib, nii et Ellie Docs teab täpselt, mida jälgida.

🚨

Aegumise tuvastus liitmisel

GitHubi rakendus jälgib liidetud PR-e, hindab, kas need mõjutavad seotud artiklit, ja märgib selle. Ülevaatamiseks on kohe valmis parandatud mustand, mitte lihtsalt punane riba.

📘

API viide, spetsifikatsiooniga või ilma

On sul OpenAPI spetsifikatsioon? Ellie hoiab viite sellega sünkroonis ja võrdleb iga versiooni puhul katkestavate muudatuste leidmiseks. Spetsifikatsiooni pole? Ta tuletab selle sinu marsruutidest ja päringuvalideerijatest ning viitab iga välja taga olevale koodile.

KUIDAS SEE TÖÖTAB

Ühenda korra. Dokumentatsioon püsib sellest peale ausana.

1

Ühenda oma hoidla

Paigalda Ellie Docsi GitHubi rakendus hoidlatesse, millest sinu tootedokumentatsioon sõltub. Me ei säilita sinu hoidla koopiat: kood tuuakse kätte siis, kui Ellie'l on seda vaja lugeda, ja hiljem tuuakse uuesti commit'i järgi.

2

Impordi oma dokumentatsioon või lase see läbi käia

Too olemasolev dokumentatsioon sisse veebilehe läbikäimise (crawl) abil või alusta nullist. Ellie Docs koostab artiklite mustandid ja seob igaühe koodi, lõpp-punktide või spetsifikatsiooniga, millest see sõltub.

3

Vaata üle, ära aja taga

Kui liitmine mõjutab seotud artiklit, märgib Ellie selle ja koostab parandi mustandi. Sinu tiim vaatab üle pakutud parandite järjekorra, selle asemel et otsida, mis katki läks.

KKK

Inseneeriatiimide KKK

Millist hoidla ligipääsu see vajab ja mida te alles hoiate?

GitHubi rakendus, mille ulatus on piiratud sinu valitud hoidlatega. Me ei säilita sinu hoidla koopiat: Ellie toob puu kätte siis, kui tal on seda vaja lugeda, ja hiljem tuuakse uuesti commit'i järgi. Alles jääb tuletatud materjal, millel artikkel seisab: iga väite taga olevad väljavõtted ja viited, et iga sinu dokumentatsiooni väite saaks jälgida selle õigustava koodini. Failidest leitud saladused peidetakse enne salvestamist ja sinu koodi ei kasutata kunagi mudelite treenimiseks.

Kas see asendab meie olemasoleva dokumentatsioonitööriista?

Jah, see ongi eesmärk. Ellie Docs majutab ja renderdab avaliku abikeskuse ise, sealhulgas oma domeenid, nii et sa ei pea kahte süsteemi paralleelselt käitama.

Kas me saame API viite luua ilma OpenAPI spetsifikatsioonita?

Jah. Suuna Ellie Docs spetsifikatsioonile ja ta hoiab viidet selle põhjal ajakohasena, võrreldes iga uue versiooniga, kui sinu API areneb. Ilma selleta tuletab Ellie spetsifikatsiooni sinu koodist: lõpp-punktid ruuterist, väljatüübid päringuvalideerijatest ja kõige jaoks, mida kood otsesõnu ei ütle, uurimise, mis peab viitama ridadele, millest iga välja tuletas. Tuletatud lõpp-punktid jäävad privaatseks, kuni need üle vaatad, nii et sisemised marsruudid ei lekiks sinu avalikku viitesse.

Mis siis, kui me pakume ka kliendituge?

Kasuta Ellie Docsi koos Ellie Desk'iga (varajane ligipääs): lahendatud tugipiletitest saab ühe klõpsuga uus dokumendiartikkel ja Desk'i tehisintellekti mustandid hakkavad automaatselt põhinema sinu avaldatud dokumentatsioonil.

Mis see maksab?

Tasuta plaan, edasi alates $65 kuus aastase arvega. Vaata hindu →

Lõpeta tugipiletist teada saamine.

Tasuta plaan, kaardita. Sinu esimene mustand on valmis juba esimese istungiga.

Alusta tasuta

Ehitad hoopis Lovable'i, Bolti või v0-ga? Vaata Ellie Docsi vibe-coding'u rakendustele →