AI ለቴክኒካል ጸሐፊዎች

ቴክኒካዊ አጻጻፍ ለረጅም ጊዜ በከፊል በራስ-ሰር ተሠርቷል. የማመሳከሪያ ሰነድ በመደበኛነት ከኮድ አስተያየቶች ወይም የኤፒአይ ዝርዝሮች እንደ Swagger UI፣ Redoc እና Sphinx autodoc ካሉ መሳሪያዎች የመነጨ ነው። ጄኔሬቲቭ AI የሚጨምረው ፕሮስ ነው፡ ሃሳባዊ ማብራሪያዎች፣ መማሪያዎች፣ ምሳሌዎች፣ የመልቀቂያ ማስታወሻዎች እና የመጀመሪያ ረቂቆች ከምርት መስፈርቶች ሰነዶች ወይም የምህንድስና ማስታወሻዎች። ብዙ ቡድኖች በሰነዶች-እንደ-ኮድ ሞዴል ውስጥ ይሰራሉ። ዶክመንቴሽን በጂት ውስጥ እንደ Markdown ወይም restructuredText ይኖራል፣ ለውጦች በጉትት ጥያቄዎች በኩል ያልፋሉ፣ እና ቀጣይነት ያለው ውህደት ጣቢያውን እንደ Docusaurus፣ MkDocs ወይም Sphinx ባሉ የማይንቀሳቀስ ጣቢያ ጀነሬተር ይገነባል። ይህ ማዋቀር AI በደንብ ይስማማል። ረቂቆች እንደ ሊገመገሙ ለውጦች ይመጣሉ፣ አውቶሜትድ ቼኮች በእያንዳንዱ ቃል ኪዳን ላይ ይሰራሉ፣ እና የሰነድ ዝማኔዎች ካስከተለባቸው የኮድ ለውጦች ጋር ሊተሳሰሩ ይችላሉ። ለቅጥ ወጥነት ፣ ቆራጥ መሣሪያዎች እና AI እርስ በእርስ ይጣጣማሉ። እንደ ቫሌ ያለ ሊንተር ከቅጥ መመሪያ መመሪያዎችን ያስፈጽማል፣ ለምሳሌ የGoogle የገንቢ ሰነድ ዘይቤ መመሪያ ወይም የMicrosoft የአጻጻፍ ዘይቤ መመሪያ እና ሁልጊዜ ተመሳሳይ ውጤት ይሰጣል። AI ይበልጥ ግልጽ የሆኑ ሀረጎችን ለመጠቆም የተሻለ ነው, ነገር ግን እምብዛም ሊተነበይ የሚችል አይደለም. ዋናው አደጋ የመተማመን ትክክለኛነት ነው. አንድ ሞዴል የመጨረሻ ነጥብ፣ ነባሪ እሴት ወይም አሳማኝ የሚመስል የትእዛዝ መስመር ባንዲራ መፍጠር ይችላል። እንዲሁም አንድ ምርት አሁን ካለው ባህሪ ይልቅ በስልጠና ውሂቡ ውስጥ ያለውን ባህሪ መግለጽ ይችላል። እያንዳንዱ የመነጨ የኮድ ናሙና እና መለኪያ ከእውነተኛው ስርዓት ጋር መፈተሽ ያስፈልገዋል። አንድ የተለመደ የተሳሳተ ግንዛቤ AI ቴክኒካዊ ፀሐፊዎችን አላስፈላጊ ያደርገዋል. የሥራው አስቸጋሪ ክፍሎች እውነት የሆነውን ማወቅ፣ ተጠቃሚዎች የሚፈልጉትን ነገር መወሰን እና መረጃን እንዲያገኙት ማደራጀት ናቸው። እንደ ዲያታክሲስ ያሉ ማዕቀፎች፣ አጋዥ ስልጠናዎችን፣ እንዴት እንደሚመሩ፣ ማጣቀሻ እና ማብራሪያን የሚለዩ፣ ያንን መዋቅራዊ ስራ ያንፀባርቃሉ። ሚናዎች ወደ መረጃ አርክቴክቸር፣ ማረጋገጫ፣ የይዘት ስልት እና ለ AI አንባቢዎች መፃፍ እየተቀየሩ ነው። ከ2024 የመጣው የllms.txt ፕሮፖዛል፣ ለምሳሌ፣ የቋንቋ ሞዴሎችን ወደ አንድ ጣቢያ ቁልፍ ሰነድ የሚያመለክት ፋይል ይጠቁማል።