HejuruUbuyobozi bukurikira
Uko gutsinda igihombo cy'umwanditsi ukoresheje AI
Porogaramu
Ubuyobozi
AI kubanditsi ba tekinike bisobanura gukoresha imiterere yindimi mugutegura inyandiko zivuye mubisobanuro na kode, komeza imiterere ihamye, kandi ushyigikire inyandiko-nkakazi-kode yakazi, mugihe umwanditsi aguma ashinzwe ukuri nukuri.
Umva iki gitaboAI-byavuzwe · ~3 min
Nibyingenzi kuko inyandiko akenshi ziba inyuma yibicuruzwa byihuta. AI irashobora kwihutisha gutegura no kuvugurura, ariko irashobora kandi guhimba ibipimo cyangwa imyitwarire yumvikana neza.
Kwandika tekiniki byakozwe igice kinini mugihe kirekire. Inyandiko zerekana zisanzwe zitangwa kubitekerezo bya code cyangwa ibisobanuro bya API hamwe nibikoresho nka Swagger UI, Redoc na Sphinx autodoc. Icyo AI ibyara inyungu yongeraho ni prose: ibisobanuro byibitekerezo, inyigisho, ingero, inyandiko zisohora hamwe nimbanzirizamushinga yambere yanditswe mubicuruzwa bisabwa cyangwa inoti yubuhanga. Amakipe menshi akora muri doc-as-code moderi. Inyandiko ibaho nka Markdown cyangwa Yongeye Kwubaka muri Git, impinduka zinyura mubisabwa gukurura, kandi guhuza kwubaka byubaka urubuga hamwe na generator yurubuga ruhagaze nka Docusaurus, MkDocs cyangwa Sphinx. Iyi mikorere ikwiranye na AI neza. Inyandiko ziza nkimpinduka zishobora gusubirwamo, kugenzura byikora kuri buri cyemezo, kandi ivugurura rya doc rirashobora guhuzwa nimpinduka za code zabateye. Kuburyo buhoraho, ibikoresho bya deterministic na AI byuzuzanya. Intangiriro nka Vale yubahiriza amategeko kuva muburyo bwo kuyobora, kurugero Google yatezimbere ibyangombwa byuburyo bwubuyobozi cyangwa Microsoft Yandika Imyandikire, kandi itanga ibisubizo bimwe buri gihe. AI nibyiza mugutanga interuro isobanutse, ariko ntibiteganijwe. Ibyago nyamukuru ni ibyiringiro bidahwitse. Icyitegererezo gishobora guhimba iherezo, agaciro gasanzwe cyangwa itegeko-umurongo ibendera risa neza. Irashobora kandi gusobanura uburyo igicuruzwa cyitwaye mumyitozo yacyo aho kwitwara ubu. Buri kode yakozwe kode nicyitegererezo ikeneye kugenzura sisitemu nyayo. Igitekerezo gikocamye ni uko AI ituma abanditsi ba tekinike badakenewe. Ibice bikomeye byakazi ni ukumenya ukuri, guhitamo ibyo abakoresha bakeneye, no gutegura amakuru kugirango babone. Ibikorwa nka Diátaxis, bitandukanya inyigisho, uburyo-bwo kuyobora, kwerekanwa no gusobanura, byerekana uwo murimo wubatswe. Uruhare rugenda rugana amakuru yububiko, kugenzura, ingamba zirimo no kwandika kubasomyi ba AI. Icyifuzo cya llms.txt kuva 2024, kurugero, cyerekana dosiye yerekana imiterere yururimi ibyangombwa byingenzi byurubuga.
Umwanditsi aha AI ibisobanuro bya OpenAPI hamwe nurupapuro rwurupapuro rwitsinda hanyuma agasaba incamake yibitekerezo hamwe no gutangira inzira. Noneho bakoresha buri kode ntangarugero kubidukikije.
Ububiko bwa docs bukoresha urutonde rwa Vale mugukomeza kwishyira hamwe kumagambo yabujijwe nijwi ryumvikana. Umufasha wa AI atanga igitekerezo cyo kwandika interuro yashyizwe ahagaragara, kandi umwanditsi yemera cyangwa akanga buri kimwe.
Iyo icyifuzo cya injeniyeri gisaba guhindura ibendera, intambwe ya AI itegura inyandiko ihuye nimpinduka. Umwanditsi arabisubiramo mbere yo guhuza.
Umwanditsi avugurura urupapuro rurerure rwo gukemura ibibazo mubice byiganjemo imitwe isobanura. Ibyo bifasha abasomyi babantu nabafasha ba AI bakuramo ibice muri doc.
Inyandiko zishobora gutangwa no kuvugururwa ubudahwema, hamwe nimpinduka za code, hamwe nogutegura AI kandi abantu barabyemera. Abasomyi benshi bazagera kuri doc babinyujije mubafasha ba AI aho gushakisha, bizamura agaciro kubintu nyabyo, byubatswe neza bikora iyo bisomwe mubice. Amasezerano nka llms.txt aracyari ibyifuzo, kandi kubyemera ntibizwi. Ibisabwa gutegurwa neza birashobora kugabanuka, mugihe icyifuzo cyabantu bashobora kugenzura neza tekiniki, igishushanyo mbonera cyamakuru hamwe nubwiza bwinyandiko zishobora gukomeza cyangwa gukura. Uburyo isoko ryakazi rizacamo ibice ntibirasobanuka.
Ibaruwa y'amakuru y'ubuntu
Inkuru eshatu zizewe za AI buri gitondo cy'iminsi y'akazi, zanditse mu rurimi rworoshye. Ubuntu iteka ryose, nta kwamamaza.
Imeri imwe buri munsi y'akazi. Kwiyimura mu buryo bumwe. Ntitwigera tugurisha cyangwa ngo dusangire aderesi yawe.
Isuzume
Ibisubizo ako kanya kuri buri kibazo, n'icyemezo gishobora gusangirwa gifite ID yagenzurwa umaze gutsinda isomo.
Fasha uburezi bwa AI bw'ubuntu. AI Understanding ni umuryango utegamiye kuri leta wa 501(c)(3) — nta kwamamaza, nta kwishyura, iteka ryose. Tanga impano
AI kubanditsi ba tekinike bisobanura gukoresha imiterere yindimi mugutegura inyandiko zivuye mubisobanuro na kode, komeza imiterere ihamye, kandi ushyigikire inyandiko-nkakazi-kode yakazi, mugihe umwanditsi aguma ashinzwe ukuri nukuri. Nibyingenzi kuko inyandiko akenshi ziba inyuma yibicuruzwa byihuta. AI irashobora kwihutisha gutegura no kuvugurura, ariko irashobora kandi guhimba ibipimo cyangwa imyitwarire yumvikana neza.
Vale ni prose yerekana amategeko yubahiriza imiterere. Ibyifuzo bya AI kumvugo isobanutse neza ntibiteganijwe.
Muri doc-as-code, docs iba muri Git nka Markdown cyangwa ibisa nayo, unyuze mubisabwa gukurura, kandi byubatswe na CI hamwe na generator yurubuga ruhagaze.
Diátaxis itandukanya inyandiko mubyigisho, uburyo-bwo kuyobora, kwifashisha no gusobanura, buriwese akoresha umukoresha utandukanye.
Ibyiringiro bidahwitse nibyo byago nyamukuru. Ingero zikorwa zituma ibipimo byahimbwe binanirwa kubaka.
Byasabwe muri 2024, llms.txt ni amasezerano yo kuyobora icyitegererezo cyururimi kuri doc zingenzi. Iyemezwa ryayo ntikiramenyekana.
Komeza wige
Abandi bayobozi batoranijwe kuriyi ngingo
HejuruUbuyobozi bukurikira
Uko gutsinda igihombo cy'umwanditsi ukoresheje AI
Porogaramu