Suriin ang nilalaman
Isa sa mga pinakamahalagang paraan upang suriin ang isang magaspang na burador ay ang tingnan ang nilalaman—gaano ito kasimple! Ang lahat ng magagandang transisyon, magandang organisasyon, at malinaw na estruktura ng pangungusap sa mundo ay hindi makatutulong sa isang techdoc na walang tamang nilalaman. Ang nilalaman ng isang techdoc ay maaaring "mali" sa iba't ibang paraan:
- Maaaring mawala nang tuluyan: halimbawa, isipin na may sumulat ng ulat tungkol sa "mga virtual na komunidad" ngunit hindi nag-abala na tukuyin kung ano ang ibig sabihin ng terminong iyon. Mahirap itong simulan mula sa aking ulat.
- Nandiyan ito ngunit hindi sapat: kunin ang parehong halimbawa—isiping ang manunulat ay gumawa lamang ng ilang malalabong pahayag tungkol sa mga virtual na komunidad. Ang kinakailangan ay hindi bababa sa isang talata tungkol sa paksa, kung hindi man isang buong 3 o 4 na pahinang seksyon.
- Nasa iyon pero nasa maling antas para sa mga mambabasa: Posible ring ipresenta ang impormasyon sa maling antas batay sa kaalaman, background, o pangangailangan ng mga mambabasa. Isipin na ang manunulat ay naglalaman ng isang 3-pahinang seksyon tungkol sa data caching ngunit isinulat para sa product developer (isang "dalubhasa") na mambabasa habang ang ulat ay talagang layong iparating sa mga hindi espesyalista.
Kung makakakuha ka ng pakiramdam kung paano hindi sapat ang impormasyon sa isang paunang draft ng ulat, dapat ay nasa tamang landas ka na upang malaman kung ano ang tiyak na dapat gawin upang i-revise ito. Isang kapaki-pakinabang na kasangkapan sa pag-iisip ay ang mag-isip sa mga tuntunin ng mga uri ng nilalaman.
Gamitin ang mga tanong na ibinigay sa nilalaman ng dokumento upang suriin ang iyong paunang burador para sa mga uri ng impormasyon na dapat idagdag o baguhin.
Suriin ang istruktura ng iyong mga nilalaman
Mayroong dalawang paraan ng pagtingin sa organisasyon ng impormasyon sa isang dokumento:
- isa, na tatalakayin sa susunod na seksyon, ay ang pagtingin sa pagkakasunud-sunod ng mga bahagi ng impormasyon, at tinitingnan kung sila ay nasa tamang ayos.
- Isa pang aspeto ay ang antas ng impormasyon. Maaari mong tingnan ang mga pangungusap o talata sa isang paunang burador at makita na ang ilang mga pangungusap ay pumapasok sa mas malalim na antas ng talakayan tungkol sa paksa kaysa sa iba. Ang ibang mga pangungusap ay kumikilos bilang balangkas kung saan nakadepende ang mga pangungusap na mas malalim ang nilalaman. Sa pagtingin sa estruktura sa ganitong paraan, hindi mo lamang nasusuri ang organisasyon nito kundi nakakakuha ka rin ng maraming magagandang ideya kung paano mapabuti ang nilalaman ng teksto.
Isang mas detalyadong paliwanag ang ibinibigay sa pagsasama at pagsasak subordinate sa mga talata.
Suriin ang organisasyon
Kung mayroon kang tamang nilalaman sa isang ulat, mayroon ka na ang lahat ng "tamang impormasyon" na available para sa mga mambabasa. Gayunpaman, maaari pa rin itong hindi maayos na nakasasaayos— tulad ng kapag kakalipat mo lang at magulo ang lahat o nakabalot pa sa mga kahon. Kailangan mo ng dalawang mahalagang kasanayan para suriin ang kaayusan ng isang paunang draft:
- Tukuyin ang paksa ng mga piraso ng impormasyon sa iba't ibang antas. Upang tasahin ang pagkakaayos ng isang grupo ng mga talata, magsimula ka sa pag-iisip ng isang salita o parirala upang tukuyin ang paksa ng bawat talata—sa ibang salita, magkaroon ng kaalaman sa bawat isa. Pagkatapos ay humakbang ka palayo mula sa mga salitang iyon o mga parirala, isinasalang-alang kung sila ay nasa tamang pagkakasunod-sunod. Gayunpaman, isa lamang iyon sa mga antas. Maaari mo ring tingnan sa loob ng isang indibidwal na talata para sa pagkakasunod-sunod nito. Sa kasong ito, tinutukoy mo ang paksa ng bawat pangungusap at isinasaalang-alang ang pagkakasunod-sunod ng mga pangungusap na iyon.
- Pumili ng pinakamahusay na pagkakasunod-sunod para sa mga piraso ng impormasyon. Kapag alam mo na ang paksa ng bawat bahagi ng impormasyon (sa kahit anong antas ng iyong pagsisiyasat), maaari mong tukuyin kung tama ang pagkakasunod-sunod nito. Ang desisyong ito ay nangangailangan ng kaalaman sa mga karaniwang pattern ng pagkakasunod-sunod; narito ang ilang halimbawa:
- Pangkalahatang → tiyak: Isang karaniwang paraan ng pag-oorganisa ay ang ayusin ang mga bahagi ng nilalaman mula sa pangkalahatan patungong tiyak. Halimbawa, ang pagdedeklara lahat ang mga solar collector ay isang mas pangkalahatang talakayan kaysa sa pagtalakay sa iba't ibang uri ng solar collector. At ang paglalarawan ng operasyon ng isang tiyak na uri ng solar collector ay mas kaunti pang pangkalahatan. Ang pattern na ito ay inilarawan dito:
Rebisyon gamit ang pangkalahatan-ngayon na tiyak na estruktura. mas natural na umpisahan sa pamamagitan ng pagtukoy kung ano ang ginagawa ng lahat ng solar collector, bago lumipat sa kanilang iba't ibang uri. - Simple, batayang → kumplikado: Isang paraan upang ayusin ang mga yunit ng isang talakayan ay simulan sa mga simple, batayan, at pangunahing yunit at pagkatapos ay lumipat sa mas kumplikado at teknikal.
- Bagay-na-nakatigil → bagay-na-nagagalaw: Ang isa pang pattern ng organisasyon ay kinabibilangan ng paglarawan muna sa bagay (parang sa isang litrato), pagkatapos ay talakayin ang operasyon o proseso nito (parang sa isang video). Maaaring maging epektibo ang pamamaraang ito para sa isang talakayan tungkol sa sistema ng fuel-injection.
- Galaw sa espasyo: — Kung ilalarawan mo ang mga pisikal na detalye ng isang bagay, maaaring gusto mong gumamit ng ilang uri ng pisikal na galaw, halimbawa, mula itaas hanggang ibaba, mula kaliwa hanggang kanan, o mula labas papasok.
- Pansamantalang paggalaw: — Isa sa pinaka-karaniwang mga pattern ay nakabatay sa paggalaw sa loob ng panahon; ayusin ang talakayan ng mga pangyayari ayon sa pagkakasunod-sunod ng oras.
- Konsepto → aplikasyon ng konsepto, mga halimbawaIsang karaniwang estrukturang organisasyonal ay talakayin ang isang konsepto sa pangkalahatang mga termino at pagkatapos ay talakayin ang isang aplikasyon nito. Halimbawa, ang ibang kabanata sa aklat na ito ay unang naglalahad ng mga mungkahi sa konseptwal na paraan at pagkatapos ay tinatalakay ang mga halimbawa ng mga mungkahi.
- Data → konklusyon: Isa pang paraan ng pag-oorganisa ng impormasyon ay ang ipakita ang mga datos (mga obserbasyon, datos mula sa eksperimento, mga resulta ng survey) at pagkatapos ay lumipat sa mga konklusyon na maaaring mabuo mula sa mga datos na iyon. (At minsan ay baligtad ang pagkakaayos: ipakita ang konklusyon muna, pagkatapos ay ang mga datos na sumusuporta dito.)
- Problema, tanong → solusyon, sagot: Maaari mo ring ayusin ang impormasyon sa pamamagitan ng unang talakayin ang isang problema o magtaas ng isang tanong at pagkatapos ay lumipat sa solusyon o sagot.
- Pinadaling bersyon → detalyadong bersyon: Isang kapaki-pakinabang na paraan upang ipaliwanag ang mga teknikal na bagay sa mga hindi espesyalista ay ang magsimula sa pagtalakay ng isang pinadaling bersyon ng bagay, itaguyod ang isang solidong pag-unawa dito, pagkatapos ay bumalik at ipaliwanag muli ang lahat ngunit sa pagkakataong ito ay puno ng teknikal na detalye!
- Pinakamahalaga → pinakabihira: Isang mas "rhetorical" na pamamaraan ng pag-oorganisa ay ang magsimula sa pinaka-mahalaga, pinaka-kitang-kita, pinaka-dramatikong impormasyon muna at pagkatapos ay lumipat sa impormasyong unti-unting nagiging hindi kasing kahalagahan. (At ang pattern na ito ay maaaring baligtarin: maaari kang bumuo patungo sa isang rurok, sa halip na magsimula dito.)
- Pinakamakatwirang → pinakamahina ang pagkakapaniwala: — Gayundin, maaari kang magsimula sa pinaka nakakumbinsing argumento para sa iyong posisyon — upang makuha ang atensyon ng lahat — pagkatapos ay lumipat sa mas kaunti at kaunting nakakumbinsing mga argumento. (Ang pattern na ito ay maaari ring baligtarin: maaari mong buuin ang iyong pinaka nakakumbinsing mga argumento.)
- Pangkalahatang → tiyak: Isang karaniwang paraan ng pag-oorganisa ay ang ayusin ang mga bahagi ng nilalaman mula sa pangkalahatan patungong tiyak. Halimbawa, ang pagdedeklara lahat ang mga solar collector ay isang mas pangkalahatang talakayan kaysa sa pagtalakay sa iba't ibang uri ng solar collector. At ang paglalarawan ng operasyon ng isang tiyak na uri ng solar collector ay mas kaunti pang pangkalahatan. Ang pattern na ito ay inilarawan dito:
Ilan lamang ito sa mga posibilidad. Kapag ang layunin ay nagbibigay ng impormasyon, inaarange mo ang impormasyon upang matiyak na nauunawaan ng mga mambabasa ang batayan bago lumipat sa mas kumplikado at teknikal na bagay. Kapag ang layunin ay nakakaakit, inaayos mo ang mga bagay upang ma-maximize ang nakakaakit na epekto sa mga mambabasa, halimbawa, sa pamamagitan ng paglalagay ng pinakamalakas na argumento muna.
At sa anumang kaso, iwasan mong paghaluin ang mga pamamaraang ito—halimbawa, itinatapon ang ilang datos, pagkatapos ay nagsasaad ng ilang konklusyon, at pagkatapos ay ginagawa ito pabalik-balik sa isang walang sistema na paraan. Panatilihing magkahiwalay ang mga mansanas sa mga kahel!
Palakasin ang mga pangungusap na paksang at mga buod.
Isa sa mga pinakamagandang bagay na maaari mong gawin ay balikan ang isang magaspang na burador at tingnan kung maaari kang maglagay ng mga pangungusap na tumatalakay sa paksa at mga buod sa mahahalagang bahagi. Kapag sumusulat tayo, kadalasang hindi tayo sigurado kung saan tutungo ang isang talata o bahagi sa mga tuntunin ng nilalaman at lohika. Kapag ito ay "naabot na," madalas na kinakailangan na balikan ang simula at magdagdag ng isang uri ng buod o baguhin ang nandoon na upang gawing mas malinaw ang buod. Kailangan malaman ng mga mambabasa kung saan sila pupunta sa isang ulat, ano ang susunod na darating, at para sa bagay na iyon, kung saan sila kakagaling lamang.
Ang pagkakaroon ng pangkalahatang tanaw sa isang ulat ay parang pagkakaroon ng mapa kapag ikaw ay nasa isang bagong lungsod. Ang mga pangungusap na paksa at pangkalahatang tanaw ay nagbibigay ng pananaw kung ano ang naroroon: ang paksa, ang mga subpaksa, ang layunin ng darating na talakayan, ang kaugnayan nito sa nakaraang bahagi at sa dokumento bilang kabuuan. (Ngayon, ang ilan sa mga ito ay may kinalaman sa mga paglilipat, na siyang susunod na elemento na dapat suriin.)
Para sa detalyadong pagtalakay ng paksang ito, tingnan ang pangungusap na pang-tema at mga pangkalahatang-ideya.
Palakasin ang pagkakaugnay, mga paglipat
Maaari kang magkaroon ng tamang impormasyon sa isang ulat at maayos itong maorganisa, ngunit maaaring may mahalagang bagay na magkamali pa rin. Maaaring hindi mapansin ng mga mambabasa ang "daloy" ng mga ideya, at magkaroon ng kahirapan sa pag-unawa kung paano ang mga bahagi ng impormasyon ay nauugnay o konektado sa isa't isa. Ang kailangan ng mga mambabasa ay tuloy-tuloy na gabay—na siyang ibinibigay mo bilang manunulat. At ang ginagamit mo para magbigay ng gabay na iyon ay tinatawag na mga transisyon—iba't ibang kagamitan na tumutulong sa mga mambabasa na maglakbay sa isang dokumento. Mayroong (o tiyak na dapat mayroon) na lohika na nag-uugnay sa bawat pangungusap sa isang dokumento at nagtutukoy ng tiyak na pagkakasunod-sunod ng mga pangungusap na iyon.
Tingnan ang kabanata sa kaangkupan at paglipat para sa detalyadong talakayan at mga halimbawa.
Suriin ang haba ng talata.
Isang huling paraan upang suriin ang iyong magaspang na draft sa antas ng estruktura ay ang tingnan kung paano mo tinukoy ang mga putol ng talata. Ang mga talata ay mga kakaibang nilalang—naniniwala ang ilang iskolar ng pagsusulat na sila'y hindi umiiral at mga arbitrariy na punto ng pahinga na itinapon ng mga manunulat kapag at saan man nila gusto. Paumanhin—sa teknikal na pagsulat, ang talata ay isang pangunahing manlalaro sa labanan para sa kalinawan at pagkaunawa. Bagaman hindi palaging posible, ang mga talata ay dapat mangyari kung saan mayroong ilang pagbabago sa paksa o subpaksa o ilang pagbabago sa paraan ng pagtalakay sa isang paksa.
Sa isang pahinang sulat na may solong espasyo, humanap ng isa hanggang apat na paghiwa-hiwalay ng talataan—walang anuman sa mahika tungkol sa karaniwang iyon kaya huwag itong ituring na parang batas. Balikan lamang ang mga mahabang talataan at suriin ang posibilidad ng mga paghiwa-hiwalay ng talataan.
Pahalagahan ko ang iyong mga opinyon, reaksyon, at kritisismo tungkol sa kabanatang ito: ang iyong sagot—David McMurrey.
