Pakisuyo na i-click dito para makatulong David McMurrey bayaran ang web hosting:
Mag-donate ng kahit anong maliit na halaga na kaya mo!
Mananatiling libre ang Online Technical Writing.

Kapag nagsusulat ka ng mga tagubilin, pamamaraan, at impormasyon tungkol sa "gabay" o user-guide, karaniwan ay kailangan mong gumamit ng pamamaraan ng gawain. Ibig sabihin nito ay pagbibigay ng mga hakbang at paliwanag para sa lahat ng pangunahing pagsusuri ng gawain na maaaring kailanganing isagawa ng mga gumagamit.

Siyempre, ang ilang mga tagubilin ay may kasamang isang gawain lamang—halimbawa, ang pagpapalit ng langis sa isang sasakyan. Ngunit tayo ay nag-aalala dito sa mga mas kumplikadong proseso. Habang ang kabanatang ito ay gumagamit ng software ng computer bilang isang halimbawa, ang mga teknikal na ito ay maaaring ilapat sa anumang multi-task na proseso—halimbawa, ang pagpapatakbo ng microwave oven.

NotebookLM-generated infographic of this chapter

Pagkilala sa mga Gawain

Upang sumulat sa isang nakatuon sa gawain na paraan, kailangan mo munang gawin ang ilang pagsusuri sa gawain. Ibig sabihin ay pag-aralan kung paano ginagamit ng mga gumagamit ang produkto o ginagawa ang gawain, makipagpanayam sa kanila, at pagmasdan sila. Maari rin itong mangahulugan ng pakikipagpanayam sa mga tao sa marketing at pagbuo ng produkto. Kung makakakuha ka ng mga uri ng tanong na natatanggap ng mga tao sa tulong, makakatulong din iyon.

Ngunit sa ilang pagkakataon, maaaring hindi ka nasa posisyon upang magawa ang masusing pagsusuri ng gawain. Kadalasan, ang mga nag-develop ng produkto ay hindi nag-iisip tungkol sa dokumentasyon hanggang sa huli. Sa mga ganitong sitwasyon, madalas na mahirap makuha ang atensyon ng mga tao sa marketing, development, engineering, at programming upang gumugol ng sapat na oras kasama ka para ipaliwanag nang buo ang produkto. At kaya't nagtatapos ka sa paggawa ng ilang uri ng pinag-isipang mga hula. Mas malamang na suriin ng developer ang iyong draft at ipaalam sa iyo kung tama ang iyong mga hula.

Upang makabuo ng iyong sariling pagsusuri ng gawain, maaari mong pag-aralan ang user interface (mga pindutan, menu, mga pagpipilian, atbp.) ng produkto. Ito ay para sa parehong hardware at software. Isaalang-alang ang interface ng isang icon editing tool na ipinakita sa ibaba. Mula sa snippet na ito ng interface, maaari mong tukuyin ang ilang halatang gawain: Bagong, Buksan, I-save Bilang, Lumabas:

  1. Magsimula ng bagong proyekto sa icon
  2. Buksan ang isang umiiral na proyekto ng icon para sa pag-edit
  3. Magsal rename ng isang icon na proyekto (I-save bilang)
  4. Lumabas AZ Icon I-edit

Interfeys para sa AZ Icon Edit

Ngayon, tingnan ang mga pagpipilian sa menu para sa susunod na bahagi ng menu. Makikita mo na kapag ang mga tao ay gumagamit ng icon editor na ito, malamang na gagawin din nila ang mga gawaing pagsusuri:

  1. Bawiin ang isang pagkakamali
  2. Kunan ng larawan ang isang imahe o ilang bahagi nito.
  3. Putulin ang isang bagay mula sa isang proyekto ng icon
  4. Kumuha ng isang bagay mula sa isang proyekto ng icon.
  5. Mag-paste ng isang bagay sa isang icon na proyekto
  6. I-flip ang buong imahe nang pahalang o patayo.
  7. I-ikot ang larawan pakaliwa
  8. Linawin ang proyekto, na malamang ay nangangahulugang magsimula muli.
  9. Ibalik, na kakailanganin mong magtanong-tanong, mag-eksperimento, o maghukay sa programming spec upang malaman.
  10. Mag-drawing gamit ang makapal, katamtaman, o manipis na linya.

Ngunit ngayon tingnan mo ang interface nang walang mga pagpipilian sa menu na nakababa. Anong karagdagang pagsusuri sa gawain ang makikita mo? Tulad ng sa maraming graphical user interfaces, ang ilan sa mga icon ay inuulit ang mga pagpipilian sa menu. Halimbawa, ang icon ng bulleted-list ay nagbibigay-daan sa iyo na pumili ng payat, katamtaman, o makapal na linya sa parehong paraan ng pag-click sa. Mga pagpipilian gagawin. Gayunpaman, may ilang bagong kagamitan dito, na hindi available sa ibang bahagi ng interface:

  1. Mag-disenyo ng tuwid na mga linya (kailangan mong mag-eksperimento para makita ang pagkakaiba sa pagitan ng dalawang icon ng lapis)
  2. Gumuhit ng mga linyang libre (ang icon na may alon)
  3. Gumuhit ng mga walang laman na parihaba (matitigas na gilid) at mga walang laman na parihaba (bilugan na gilid)
  4. Gumuhit ng walang laman na mga oblong at puno na mga oblong.
  5. Punan ng kulay (ang hypodermic needle)
  6. Pumili ng mga bahagi ng imahe upang ilipat, putulin, o i-rotate (ang icon na may tuldok na linya)
  7. Kunin ang mga larawan—o bahagi ng mga larawan— (ang net, pero paano ito gumagana?)
  8. Gumuhit ng punong mga parihaba (matutulis na sulok) at punong mga parihaba (may pabilog na sulok)
  9. Pumili ng kulay ng background (ang Button ng Screen)
  10. Pumili ng kulay ng linya o punan (ang icon na may dobleng kahon)

Marami ka pang hindi alam tungkol sa software na ito, pero nakagawa ka na ng maraming hula sa pagtukoy sa pangunahing task_analysis. Gusto mong pagsamahin at pag-isahin ang mga bagay nang mas mahigpit kaysa sa itaas, marahil tulad ng sumusunod:

Makikita mo na sa listahan ng mga gawaing ito, walang bakas ng task_analysis tulad ng pagpuno ng isang bagay ng kulay, pagkuha ng mga imahe, paglilinis ng workspace, pag-undo ng isang pagkakamali, o pagpapanumbalik. Ngunit habang nagtatrabaho ka, ang mga detalye na ito ay magsisimulang makahanap ng kanilang lugar sa iyong plano. Ngayon, humakbang pabalik mula sa mga detalye ng interface at ilagay ang iyong sarili sa lugar ng isang gumagamit ng software na icon. Anong mga tanong ang malamang na itanong ng indibidwal na iyon? Paano ko babaguhin ang kulay ng background? Nakaayos na iyon. Paano ko babaguhin ang kapal ng mga linyang iguguhit ko? Nakaayos din yan. Paano ko gagawing transparent ang background? Hmm . . . magiging isyu iyon para sa bahagi ng kulay, ngunit mangangailangan ito ng kaunting pananaliksik.

Iba't Ibang Paraan ng Dokumentasyon

Kapag sumusulat ka para sa mga gumagamit, mayroong kang pagpipilian ng dalawang diskarte, function oryentasyon at oriyentasyon sa gawain, ang huli rito ay tiyak na mas magandang pagpipilian.

Pagsusulat na may oryentasyong punsyon. Dapat na maliwanag kung paano magpatuloy matapos ang isang pagsusuri ng gawain, ngunit tila hindi. Ang mga publikasyong pang-computer—kung hindi man ang mga publikasyong teknikal sa pangkalahatan—ay madalas na nagkukulang sa isang estilo ng pagsulat na nakatuon sa gawain. Pero, hindi! Hindi talaga ito epektibo!

Isa pang dahilan kung bakit ang ilang mga tagubilin sa user guide ay hindi nakatuon sa gawain ay maaring maiugnay sa mga espesipikasyon ng produkto. Ang mga espesipikasyon ng produkto, na isinulat ng at para sa mga programmer, inhinyero, at developer, ay nakasulat sa mga tuntunin ng kinakailangang function:

Buton ng menu ng File Pinapayagan ang user na lumikha ng bagong file, buksan ang umiiral na file, palitan ang pangalan ng file, atbp.
Ipinutol na icon Pinapahintulutan ang gumagamit na i-cut ang napiling bahagi ng imahe.

Maaari mong tawagin ang pamamaraang ito nakatuon sa function ang pagsusulat dahil ito ay sistematikong nagpapaliwanag ng bawat function, feature, o elemento ng interface ng isang produkto. Sa kasamaang palad, ang ganitong paraan ay lumalabas sa mga user guide na nakalaan para sa mga hindi teknikal na mambabasa—marahil dahil ang mga manunulat ay hindi bihasa, walang pagsasanay, o hindi teknikal; o kaya naman ang mga manunulat ay nahirang na masyadong huli upang makagawa ng iba kundi ayusin na lamang ang espisipikasyon ng mga developer.

Ang function-oriented na pamamaraan ay halos gumagana paminsan-minsan. Pero ang "halos" at "paminsan-minsan" ay hindi sapat. Halos ito ay gumagana dahil ang mga pangalan ng mga elemento ng interface at mga function ay minsang tumutugma sa task_analysis na kanilang sinusuportahan. Halimbawa, ang Buksan ang opsyon sa menu ay medyo madaling maunawaan: buksan ang umiiral na file. Ang iba ay hindi. Halimbawa, ano sa palagay mo ang ibinabalik ng Ibalik button sa AZ Icon Edit interface? Gayundin, ang ilang mga elemento ng interface ay hindi nagagawa ang mga gawain nang mag-isa. Sa Photoshop, halimbawa, hindi mo ma-crop ang teksto sa pamamagitan ng pagpindot sa Anihin menu na pagpipilian. Kailangan mong i-click muna ang button para sa pagpili ng teksto, pagkatapos ay gumuhit ng isang kahon ng seleksyon sa paligid ng bahagi ng larawan na nais mong panatilihin, pagkatapos ay pindutin ang Anihin pindutan.

Pagsusulat na may layuning nakatuon sa gawain.Sa halip na ang nakatuon sa function, gamitin ang nakatuon sa gawain. Tukuyin ang mga gawain na kailangang isagawa ng mga gumagamit gamit ang produkto, at pagkatapos ay i-istruktura ang iyong dokumento nang naaayon. Gawing malinaw ang iyong mga pamagat at sub-pamagat. nakatuon sa gawain sa kanilang pagkakasalita. Ang nakatuon sa gawain na pagkakasalita ay nangangahulugang pagkakasalita gaya ng "Paano ayusin ang lakas ng tunog," "Pag-aayos ng lakas ng tunog," o "Ayusin ang lakas ng tunog." Hindi ito nangangahulugang pagkakasalita gaya ng "Lakas ng tunog" o "Pag-aayos ng Lakas ng Tunog." Narito ang ilang karagdagang halimbawa:

Pagsasaayos ng problema Pagbabalangkas na nakatuon sa gawain
Kuhanan Pagkuha ng mga larawan
Buton ng screen Pumili ng mga bagay na nasa likuran o nasa harapan
Mga Parihaba Pagguho ng mga parihaba
Oblong na icon Pagdrawing ng mga oval at bilog

Kapag nailarawan mo na ang user task_analysis, na-organisa ito sa mga lohikal na grupo, at naitala ang mga nakatuon sa gawain na pamagat, handa ka nang sumulat! Narito ang isang sipi:

Pagbuo ng mga Parihaba at Obal

Maaari mong gamitin ang icon editor para gumuhit ng mga parisukat, parihaba, mga obalo, at mga bilog.

Magdrawing ng parihaba. Upang gumuhit ng isang rektanggulo:
  1. Siguraduhin na napili mo ang kulay ng unahan na gusto mo. (Tingnan ang "Pumili ng kulay ng unahan.")
  2. I-click ang hugis-parihaba na icon.
  3. Iposisyon ang pointer ng mouse sa lugar ng pagguhit kung saan mo gustong lumabas ang rektanggulo, hawakan ang kaliwang pindutan ng mouse, at i-drag upang malikha ang rektanggulo.
Magdrawing ng oblong. Para gumuhit ng obalo:
  1. Tiyakin na . . .

Sa siping ito, makikita mo na isang pangkalahatang nakatuon sa gawain na lapit ang ginagamit at ang mga parirala na nakatuon sa gawain ay ginamit para sa mga pamagat (Pagdrawing). Pansinin din na ang mga numeradong listahan ay ginagamit upang gabayan ang mga mambabasa hakbang-hakbang sa mga aksyon na kasangkot sa gawain.

Kaugnay na Impormasyon

Gawain sa Pagsulat batay sa Tungkulin. WTD

Pahalagahan ko ang iyong mga saloobin, reaksiyon, at kritisismo hinggil sa kabanatang ito: ang iyong tugon.