Pagpapakilala sa Mga Tagubilin

Ang mga tagubilin ay isang espesyal na uri ng teksto na naglalahad kung paano isagawa ang isang gawain o proseso. Maaari itong maging kasing-simple ng pagluluto ng isang recipe o kasing-komplikado ng pagpapatakbo ng isang software system.

Sa kabanatang ito, matututuhan mo ang iba't ibang aspeto ng pagsulat ng mga tagubilin, kabilang ang:

• Paggamit ng mga heading para sa organisasyon
• Paggamit ng mga listahan para sa malinaw na hakbang-hakbang na paglalarawan
• Paggamit ng mga espesyal na paalala o babala upang maiwasan ang error o aksidente

Ano ang Gagawin ng Mga Tagubilin

Ang pangunahing layunin ng mga tagubilin ay gabayan ang mambabasa sa pagganap ng isang gawain. Maaaring kasama rito ang:

• Paggabay sa paggawa ng pisikal na gawain (hal. pag-assemble ng kasangkapan)
• Pagtuturo ng paggamit ng software o teknolohiya
• Pagpapakita kung paano makumpleto ang proseso ng administratibo o pamahalaan

Sa pamamagitan ng malinaw na pagsunod sa mga hakbang, mas madali para sa mambabasa na makamit ang tamang resulta at maiwasan ang pagkakamali.

Para sa istilo at format ng mga posibilidad na ito, tingnan ang kabanata tungkol sa mga listahan.

Pagtutok sa Detalye

Ang mga tagubilin ay kadalasang naglalaman ng detalyado at malinaw na paglalarawan ng bawat hakbang. Ang paggamit ng numbering o bullet points ay nakakatulong upang maiwasan ang pagkalito. Mahalagang maglaan ng espesyal na babala kung may hakbang na may potensyal na panganib.

Sa puntong ito, malamang ay natutunan mo na ang tungkol sa mga heading, listahan, at espesyal na paalala—ang pagsusulat ng tagubilin gamit ang mga ito ay tila halata na. Hatiin lamang ang paliwanag sa numbered vertical lists at maglagay ng espesyal na paalala sa mga malinaw na punto at tapos na! Hindi pa ganap, ngunit magandang panimulang hakbang ito.

Sa kabanatang ito, tatalakayin natin ang ilang tampok ng mga tagubilin na maaaring gawing mas kumplikado ang mga ito. Magagamit mo rin ang mga konsiderasyong ito sa pagpaplano ng iyong sariling mga tagubilin.

Mga Tip sa Pagsusulat

• Tiyakin na malinaw ang bawat hakbang at walang hindi malinaw na salita
• Gumamit ng mga heading at subheading upang madaling mahanap ang impormasyon
• Maglagay ng mga espesyal na babala o paalala kung kinakailangan upang maiwasan ang panganib o pagkakamali
• Subukang basahin ang tagubilin mula sa pananaw ng mambabasa upang matiyak ang lohikal na daloy

Sa pagsunod sa mga prinsipyo at tips na ito, makakalikha ka ng malinaw, kapaki-pakinabang, at epektibong tagubilin para sa iyong mambabasa.

Pagpapakilala sa Mga Tagubilin

Ang mga tagubilin ay isang espesyal na uri ng teksto na naglalahad kung paano isagawa ang isang gawain o proseso. Maaari itong maging kasing-simple ng pagluluto ng isang recipe o kasing-komplikado ng pagpapatakbo ng isang software system.

Sa kabanatang ito, matututuhan mo ang iba't ibang aspeto ng pagsulat ng mga tagubilin, kabilang ang:

• Paggamit ng mga heading para sa organisasyon
• Paggamit ng mga listahan para sa malinaw na hakbang-hakbang na paglalarawan
• Paggamit ng mga espesyal na paalala o babala upang maiwasan ang error o aksidente

Ano ang Gagawin ng Mga Tagubilin

Ang pangunahing layunin ng mga tagubilin ay gabayan ang mambabasa sa pagganap ng isang gawain. Maaaring kasama rito ang:

• Paggabay sa paggawa ng pisikal na gawain (hal. pag-assemble ng kasangkapan)
• Pagtuturo ng paggamit ng software o teknolohiya
• Pagpapakita kung paano makumpleto ang proseso ng administratibo o pamahalaan

Sa pamamagitan ng malinaw na pagsunod sa mga hakbang, mas madali para sa mambabasa na makamit ang tamang resulta at maiwasan ang pagkakamali.

Para sa istilo at format ng mga posibilidad na ito, tingnan ang kabanata tungkol sa mga listahan.

Pagtutok sa Detalye

Ang mga tagubilin ay kadalasang naglalaman ng detalyado at malinaw na paglalarawan ng bawat hakbang. Ang paggamit ng numbering o bullet points ay nakakatulong upang maiwasan ang pagkalito. Mahalagang maglaan ng espesyal na babala kung may hakbang na may potensyal na panganib.

Sa puntong ito, malamang ay natutunan mo na ang tungkol sa mga heading, listahan, at espesyal na paalala—ang pagsusulat ng tagubilin gamit ang mga ito ay tila halata na. Hatiin lamang ang paliwanag sa numbered vertical lists at maglagay ng espesyal na paalala sa mga malinaw na punto at tapos na! Hindi pa ganap, ngunit magandang panimulang hakbang ito.

Sa kabanatang ito, tatalakayin natin ang ilang tampok ng mga tagubilin na maaaring gawing mas kumplikado ang mga ito. Magagamit mo rin ang mga konsiderasyong ito sa pagpaplano ng iyong sariling mga tagubilin.

Mga Tip sa Pagsusulat

• Tiyakin na malinaw ang bawat hakbang at walang hindi malinaw na salita
• Gumamit ng mga heading at subheading upang madaling mahanap ang impormasyon
• Maglagay ng mga espesyal na babala o paalala kung kinakailangan upang maiwasan ang panganib o pagkakamali
• Subukang basahin ang tagubilin mula sa pananaw ng mambabasa upang matiyak ang lohikal na daloy

Sa pagsunod sa mga prinsipyo at tips na ito, makakalikha ka ng malinaw, kapaki-pakinabang, at epektibong tagubilin para sa iyong mambabasa.

Mga AI Prompt para sa Mga User Guide

Ang mga checklist, na kadalasang hindi nababasa, ay maaaring gamitin bilang pinagmulan ng AI prompts sa ilang pagbabago. Kopyahin ang sumusunod, i-paste sa isang AI system tulad ng Google's Gemini, at tingnan kung ano ang maaaring hindi mo napansin.

Tandaan: Lahat ng reference sa nilalaman, format, at estilo ng data reports o ng mga bahagi nito ay matatagpuan sa online technical-writing textbook.

Mga AI Prompt para sa Mga User Guide

Mayroon bang user guide ng sumusunod (tamang naka-format) sa ganitong pagkakasunod: transmittal message, front at back covers, title page; edition notice, table of contents; preface; chapters, appendixes (kung kailangan); index, back cover. Bagamat maaari itong maging masaya at malikhain, malinaw ba ang pamagat ng user guide sa paksa nito? Para sa detalye, tingnan ang user guide titles. Kung ang table of contents at list of figures (at tables) ay may leader dots, tama ba ang pagkaka-align ng page numbers sa kanan? Kung may page numbers sa kanan, ginagamit ba ang leader dots? Para sa detalye, tingnan ang TOCs and List of Figures (Tables). Ang introduction ba ay malinaw na naglalahad ng paksa, layunin, at target audience? Mayroon ba itong listahan ng subtopics at saklaw (kung ano ang hindi sakop)? Para sa detalye, tingnan ang Introductions. May sapat bang detalye, halimbawa, o paliwanag upang maipaliwanag ang mga assertions o generalities? May kulang bang mahalagang nilalaman? May sobra? May teknikal na mali? May nawawalang kritikal na impormasyon? May malinaw bang hindi dokumentadong kinuha mula sa iba? Ang citations ba ay naaayon sa APA, MLA, o modified IEEE style? Para sa detalye, tingnan ang Documentation: borrowed information sources. Lahat ba ng tables at non-decorative figures ay may descriptive title (caption) at source kung kailangan? Para sa detalye, tingnan ang Table titles. Lahat ba ng tables at non-decorative figures ay malapit sa kaugnay na teksto? May maikling explanatory cross-reference bago ang tables at non-decorative figures? Para sa detalye, tingnan ang Explanatory cross-references. Standard ba ang format ng headings at subheadings? Para sa detalye, tingnan ang Headings. Nagsisimula ba ang pangunahing sections (chapters) sa bagong pahina sa print? Gumagamit ba ng numbered vertical lists para sa required order at bulleted lists sa no required order? May lead-ins ba bago lahat ng lists? Para sa detalye, tingnan ang Vertical lists. Ang direct quotations ba ay attributed at tama ang punctuation? Tama ba ang citations ayon sa APA, MLA, o modified IEEE? Para sa detalye, tingnan ang Quotations & attributions. Libre ba sa grammar, usage, at punctuation errors? Para sa detalye, tingnan ang Common Grammar, Usage, Spelling Problems. Libre ba sa wordiness at sentence style errors? Para sa detalye, tingnan ang Wordiness, other sentence-style problems. Maiintindihan ba ang guide ng target audience? Para sa detalye, tingnan ang Audience analysis at Translating the Technical. AT, upang makumpleto ang evaluation, magbigay ng numeric grade mula 100 hanggang 55.

Related Information

Paano Sumulat ng User-Friendly Help Topics para sa Mga Baguhan. clickhelp.com

Ipinapahalaga ko ang inyong mga puna, reaksyon, at kritisismo tungkol sa kabanatang ito: iyong tugon—David McMurrey.