Nulis dokumentasi piranti lunak nduweni peran integral ing karya programmer. Kaya sing dikandhakake, yen ora didokumentasikake, mula ora ana, lan ing kasus-kasus sing paling umum, nyathet kode sampeyan kanthi cara sing bener penting kaya nulis.
“Senajan perpustakaan sampeyan apik banget lan desain sing cerdas, yen sampeyan mung siji sing ngerti, ora ana gunane. Dokumentasi tegese ora mung referensi API autogenerated, nanging uga conto annotated lan tutorial ing-ambane. Sampeyan butuh kabeh telu kanggo mesthekake perpustakaan sampeyan bisa gampang diadopsi, "
ujare Nicholas Zakas, insinyur ngarep lan penulis buku sing kondhang. Pramila dina iki kita mutusake kanggo ndeleng sawetara alat sing paling apik lan paling umum digunakake kanggo dokumentasi piranti lunak lan nulis teknis.
Alat bantu nulis
Bantuan alat pangripta nduweni peran utama ing dokumentasi piranti lunak lan panulisan teknis, amarga luwih gampang ngrancang, nulis, nerbitake, lan njaga dokumentasi piranti lunak. Iki ngidini sampeyan nyuda wektu lan tenaga sing dibutuhake nalika nggawe kabeh jinis bahan pitulung kanggo pangguna pungkasan lan programer / karyawan liyane.
MadCap Flare minangka salah sawijining alat pangripta bantuan sing paling populer amarga akeh pilihan fitur sing ngidini sampeyan nindakake luwih akeh tinimbang mung nulis dokumentasi bantuan. MadCap Flare dirancang kanggo pangarang adhedhasar topik lanjutan, penerbitan siji-sumber lan manajemen konten. Iki ngidini sampeyan nggawe situs web Bantuan lan dhukungan pelanggan, FAQ, basis pengetahuan, pusat pembelajaran online, pandhuan, manual kabijakan lan prosedur, lan liya-liyane. Fitur MadCap Flare nggampangake nggunakake maneh konten sing padha ing pirang-pirang saluran lan nerbitake kanthi cepet ing sawetara platform.
Document360 minangka platform web liyane sing akeh digunakake sing ngidini sampeyan mbangun, nerbitake lan nganyari kabeh jinis basis pengetahuan lan bahan bantuan. Uga nduweni fungsi multi-profil, kalebu editor teks Markdown sing prasaja, Manajer Kategori kanggo mbangun struktur basis pengetahuan, fitur kustomisasi kaca kebangkrutan, rollback versi, serep lan mulihake, peran fleksibel lan pangaturan ijin, lan liya-liyane.
Adobe RoboHelp minangka alat pangripta bantuan alternatif liyane sing kuat, sing nawakake pilihan fitur sing rada beda dibandhingake karo MadCap Flare lan Document360. Khususe, Adobe RoboHelp nawakake penerbitan multiformat sing gampang, ngidini sampeyan nerbitake konten menyang macem-macem format output populer, kalebu Frameless Responsive HTML5, PDF, Microsoft Help (CHM), lan malah format sing kurang umum kayata EPUB 3, KF8, lan MOBI.
Kauntungan utama Help+Manual yaiku antarmuka sing gampang diakses lan gampang digunakake, bebarengan karo fungsionalitas lengkap editor XML WYSIWYG, penerbitan multi-saluran, dhukungan lengkap kanggo proyek multimedia lan modular sing kompleks, alat Webhelp kanggo integrasi lancar saka dokumentasi menyang situs web sing aktif, lan liya-liyane.
ClickHelp uga nyedhiyakake platform web sing cukup kuat kanggo dokumentasi piranti lunak kanthi basis kawruh, FAQ, tutorial, lan format Bantuan liyane. Ndhukung macem-macem format kayata Word, HTML, RTF, CHM, ODT, CHM, Bantuan Web HTML5, PDF, DOCX, lan sapiturute. penulis lan pangguna, uga pilihan saka sawetara template sing wis dibangun kanggo desain dokumentasi.
Piranti motret layar
Umume dokumentasi piranti lunak lan bahan bantuan kudu nyakup gambar layar, mula luwih becik nggawe ringkesan ringkes babagan alat motret layar sing paling apik.
Yen sampeyan nggunakake Windows minangka OS, dilengkapi Alat Snipping, sing ngidini sampeyan nggawe gambar layar kabeh, windows kapisah utawa bagean layar, lan nggunakake alat pena kanggo nyorot sawetara bagean tartamtu saka gambar kasebut.
FireShot minangka plugin browser populer sing ndhukung kabeh browser modern kayata Chrome, Firefox, Internet Explorer, lan Opera. Ngidini sampeyan njupuk kabeh kaca web utawa sawetara bagean tartamtu.
SnagIt minangka alat motret layar sing luwih rumit. Iki ngidini sampeyan njupuk area gulung ing kaca apa wae, uga ndhukung rekaman video. Sampeyan uga bisa nggunakake gambar iki kanggo nggawe GIF lan ngrekam set tumindak tartamtu ing layar.
Ejaan lan grammar checkers
Priksa manawa dokumentasi ditulis kanthi bener tanpa kesalahan tata basa lan tanda baca uga penting. Ing ngisor iki sawetara alat sing bakal mbantu sampeyan nemokake kesalahan ing teks lan ndandani.
Salah sawijining pamriksa ejaan lan grammar online gratis sing paling populer. Scribens bisa ngenali lan mbenerake luwih saka 250 macem-macem jinis kesalahan, kalebu nomina, pronoun, preposisi, kriya, homonim, tanda baca, tipografi, lan liya-liyane.
Alat gratis liyane sing apik sing nemokake macem-macem kesalahan ing teks sampeyan lan menehi sawetara pilihan kanggo nambah tembung sampeyan.
Minangka tambahan kanggo nuduhake kesalahan ketik lan kesalahan ing teks sampeyan, Grammar.com menehi saran sing cocog uga aturan tata basa lan ebook kanggo nambah tulisan sampeyan (kabeh gratis).
Apa maneh sing kudu diwaca: |
|
GO TO FULL VERSION