Suriin ang nilalaman
NotebookLM-generated infographic of this chapter
Isang sa mga pinakamahalagang paraan upang suriin ang isang magaspang na burador ay ang pagtseky ng nilalaman—ganoon kadali iyon! Ang lahat ng magagandang transisyon, magandang organisasyon, at malinaw na estruktura ng pangungusap sa mundo ay hindi makakatulong sa isang techdoc na walang tamang nilalaman. Ang nilalaman ng isang techdoc ay maaaring "mali" sa ilang paraan:
- Maaari itong tuluyang mawala: halimbawa, isipin na may naglathala ng ulat tungkol sa "mga virtual na komunidad" ngunit hindi naman pinansin na ipaliwanag kung ano ang kahulugang iyon. Mahihirapan mula sa simula ng ulat na iyon.
- Nandiyan ito pero hindi ito sapat: kunin ang parehong halimbawa—isiping ang manunulat ay gumawa lamang ng ilang malabong 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.
- Nandiyan ito pero sa maling antas para sa audience: Posible ring ipresenta ang impormasyon sa maling antas sa mga kaalaman, background, o pangangailangan ng mga mambabasa. Isipin na ang manunulat ay nagsama ng 3-pahinang seksyon tungkol sa data caching ngunit nakasulat para sa mga product developer (isang "eksperto") na audience kapag ang ulat ay talagang nakalaan para sa mga hindi espesyalista.
Kung makakakuha ka ng ideya kung paano kulang ang impormasyon sa isang ulat na draft, dapat ay nasa tamang landas ka na upang malaman kung ano ang dapat mong gawin upang i-revise. Isang kapaki-pakinabang na kasangkapan sa pag-iisip ay ang isipin 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 estruktura ng iyong nilalaman.
Mayroong dalawang paraan upang tingnan ang organisasyon ng impormasyon sa isang dokumento:
- isa, na tatalakayin sa susunod na bahagi, ay kinabibilangan ng pagtingin sa pagkakasunod-sunod ng mga piraso ng impormasyon, at tingnan kung ito ay nasa tamang kaayusan.
- Ang isa pang bagay ay may kinalaman sa antas ng impormasyon. Maaari mong tingnan ang mga pangungusap o talata sa isang magaspang na burador at makita na ang ilan sa mga pangungusap ay pumapasok sa mas malalim na antas ng talakayan sa paksa kaysa sa iba. Ang ibang pangungusap ay nagsisilbing balangkas na pinagkakabitan ng mga pangungusap na may mas malalim na antas. Sa pamamagitan ng pagtingin sa estruktura sa ganitong paraan, hindi mo lamang sinusuri ang organisasyon nito kundi nakakuha ka rin ng maraming magagandang ideya tungkol sa kung paano mapabuti ang nilalaman ng teksto.
Mas detalyadong paliwanag ang ibinibigay sa pagsasaayos at pagsasak subordinate sa talata.
Suriin ang organisasyon
Kung mayroon ka ng tamang nilalaman sa isang ulat, at least mayroon ka ng lahat ng "tamang bagay" na available para sa mga mambabasa. Gayunpaman, maaaring hindi pa rin ito maayos na nakaayos—tulad ng kapag kakalipat mo lang at ang lahat ay magulo o nasa mga kahon pa. Kailangan mo ng dalawang mahahalagang kasanayan para sa pagsusuri ng pagkakaayos ng isang magaspang na burador:
- Tukuyin ang paksa ng mga bahagi ng impormasyon sa iba't ibang antas. Upang suriin ang kaayusan ng isang hanay ng mga talata, magsimula ka sa pag-iisip ng isang salita o parirala upang tukuyin ang paksa ng bawat talata—sa madaling salita, alamin ang bawat isa. Pagkatapos, lumayo ka mula sa mga salitang iyon o parirala, isaalang-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 organisasyon. Sa kasong ito, tinutukoy mo ang paksa ng bawat pangungusap at isinasaalang-alang ang pagkakasunod-sunod ng mga pangungusap.
- Pumili ng pinakamahusay na pagkakasunod-sunod para sa mga bahagi ng impormasyon. Kapag alam mo na ang paksa ng bawat bahagi ng impormasyon (sa kahit anong antas ng iyong pagsisiyasat), maaari mo nang pagdesisyunan kung nasa tamang pagkakasunud-sunod ang mga ito. Ang desisyong ito ay kinabibilangan ng kaalaman sa mga karaniwang pattern ng pagkakasunud-sunod; narito ang ilang halimbawa:
- Pangkalahatang → tiyak: Isang karaniwang paraan ng pag-oorganisa ay ang pag-aayos ng mga piraso ng nilalaman mula sa pangkalahatan tungo sa tiyak. Halimbawang pagbibigay ng kahulugan 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 partikular na uri ng solar collector ay kahit na mas tiyak. Ang pattern na ito ay nailarawan dito:
Rebisyon gamit ang pangkalahatang-tilo tiyak na istrukturang pattern. mas natural ang pag-usad na simulan sa pamamagitan ng pagtukoy kung ano ang ginagawa ng lahat ng solar collector, at pagkatapos ay lumipat sa kanilang iba't ibang uri. - Simple, batay na → kumplikado: Isang paraan upang ayusin ang mga yunit ng isang talakayan ay simulan sa mga simple, batayan, at pangunahing mga yunit at pagkatapos ay lumipat sa mga mas kumplikado at teknikal.
- Bagay na nakatigil → bagay na kumikilos: Ang isa pang pattern ng organisasyon ay ang pagsisimula sa paglalarawan ng bagay (na parang nasa isang larawan), at pagkatapos ay talakayin ang operasyon o proseso nito (na parang nasa isang video). Maaaring maging epektibo ang pamamaraang ito para sa talakayan ng isang fuel-injection system.
- Galaw sa espasyo: — Kung naglalarawan ka ng mga pisikal na detalye ng isang bagay, maaaring gusto mong gumamit ng ilang pattern ng pisikal na galaw, halimbawa, mula itaas pababa, mula kaliwa pakanan, o mula sa labas papasok.
- Pansamantalang paggalaw: — Isa sa mga pinaka-karaniwang pattern ay nakabatay sa paglipat sa panahon; ayusin ang talakayan ng mga kaganapan kaugnay ng pagkakasunod-sunod ng oras.
- Konsepto → aplikasyon ng konsepto, mga halimbawa: Isang karaniwang pattern ng organisasyon ay talakayin ang isang konsepto sa pangkalahatang termino, pagkatapos ay talakayin ang isang aplikasyon nito. Halimbawa, ang isa pang kabanata sa librong ito ay unang tinatalakay ang mga panukala sa konseptwal na paraan at pagkatapos ay tinatalakay ang mga halimbawa ng mga panukala.
- Data → mga konklusyon: Isa pang paraan ng pag-aayos ng impormasyon ay ang ipakita ang datos (mga obserbasyon, datos mula sa eksperimento, mga resulta ng survey) at pagkatapos ay lumipat sa mga konklusyon na maaaring makuha mula sa datos na iyon. (At minsan ang pattern na ito ay baligtad: ipakita ang konklusyon muna, pagkatapos ang datos na sumusuporta dito.)
- Problema, tanong → solusyon, sagot: Maaari mo ring ayusin ang impormasyon sa pamamagitan ng unang talakayin ang isang problema o itaas ang isang tanong, 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 dalubhasa ay simulan sa pamamagitan ng pagtalakay sa isang pinasimpleng bersyon ng bagay, itatag ang matibay na pag-unawa dito, pagkatapos ay bumalik at ipaliwanag itong muli ngunit sa pagkakataong ito ay idinidiin ang mga teknikal na detalye nang mas makapal at mabigat!
- Pinakamahalaga → pinakamaliit na mahalaga: Isang mas "rhetorical" paraan ng pag-oorganisa ay ang simulan sa pinaka-mahalaga, pinaka-kahanga-hanga, pinaka-drama na impormasyon muna at pagkatapos ay lumipat sa impormasyon na unti-unting hindi kasing mahalaga. (At ang pattern na ito ay maaaring baligtarin: maaari kang bumuo patungo sa isang climax, sa halip na magsimula dito.)
- Pinakamakapaniwala → pinakamababa ang kapani-paniwala: — Katulad nito, maaari kang magsimula sa pinaka-nakapag-uudyok na argumento para sa iyong posisyon — upang makuha ang atensyon ng lahat — pagkatapos ay lumipat sa mga mas hindi kapani-paniwala. (Maari ring baligtarin ang pattern na ito: maaari mong ipatong ang iyong pinaka-nakapag-uudyok na mga argumento.)
- Pangkalahatang → tiyak: Isang karaniwang paraan ng pag-oorganisa ay ang pag-aayos ng mga piraso ng nilalaman mula sa pangkalahatan tungo sa tiyak. Halimbawang pagbibigay ng kahulugan 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 partikular na uri ng solar collector ay kahit na mas tiyak. Ang pattern na ito ay nailarawan dito:
Ilan lamang ito sa mga posibilidad. Kapag ang layunin ay nagbibigay ng impormasyon, inaayos mo ang impormasyon upang matiyak na nauunawaan ng mga mambabasa ang mga batayan bago lumipat sa mas kumplikado at teknikal na bagay. Kapag ang layunin ay mapanghikayat, inaayos mo ang mga bagay upang madagdagan ang epekto ng panghihikayat sa mga mambabasa, halimbawa, sa pamamagitan ng paglalagay ng pinakamalalakas 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 ginagampanan ito pabalik-balik sa isang saliwang paraan. Panatilihing hiwalay ang mga mansanas sa mga kahel!
Palakasin ang mga pangungusap na paksa at mga buod
Isa sa mga pinakamahusay na bagay na maaari mong gawin ay balikan ang isang magaspang na draft at suriin kung maaari kang magdagdag ng mga pangungusap ng paksa at mga buod sa mga mahahalagang punto. Kapag sumusulat tayo, kadalasang hindi tayo sigurado kung saan talaga pupunta ang isang talata o seksyon sa mga tuntunin ng nilalaman at lohika. Kapag ito ay "umabot na," madalas na kinakailangan na balikan ang simula at magdagdag ng ilang uri ng buod o i-modify ang nasa na roon upang maging mas malinaw ang buod. Kailangan ng mga mambabasa na malaman kung saan sila pupunta sa isang ulat, kung ano ang susunod na darating, at kung saan sila galing.
Ang pagkakaroon ng buod sa isang ulat ay parang pagkakaroon ng mapa kapag nasa isang bagong lungsod ka. Ang mga pangungusap ng paksa at mga buod ay nag-aalok ng perspektibo kung ano ang naroon: ang paksa, ang mga subtopic, ang layunin ng darating na talakayan, ang ugnayan nito sa naunang seksyon at sa dokumento bilang kabuuan. (Ngayon, ang ilan dito ay may kinalaman sa mga transisyon, na siyang susunod na elemento na dapat suriin.)
Para sa detalyadong pagtalakay sa paksang ito, tingnan ang mga paksa at pangkalahatang-ideya.
Palakasin ang pagkakaugnay-ugnay, mga paglipat
Maaari kang magkaroon ng tamang impormasyon sa isang ulat at maayos itong ma-organisa, ngunit maaaring may isang mahalagang bagay na mawala. Maaaring hindi mapansin ng mga mambabasa ang "daloy" ng mga ideya, nahihirapang mapansin kung paano ang mga piraso ng impormasyon ay magkakaugnay 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 upang ibigay ang gabay na iyon ay tinatawag na transitions —mga iba't ibang kagamitan na tumutulong sa mga mambabasa sa kabuuan ng dokumento. Mayroong (o tiyak na dapat ay mayroon) isang lohika na nag-uugnay sa bawat pangungusap sa isang dokumento at nagdidikta ng tiyak na pagkakasunod-sunod sa mga pangungusap na iyon.
Tingnan ang kabanata sa kahulugan at mga 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 pag-check kung paano mo tinukoy ang mga puwang ng talata. Ang mga talata ay mga kakaibang nilalang—may ilang mga iskolar ng pagsulat na naniniwala na wala silang katotohanan at isa lamang silang arbitrary na mga pagkakaputol na itinatapon ng mga manunulat kung kailan at saan nila gusto. Pasensya na—sa teknikal na pagsulat, ang talata ay isang pangunahing kalahok sa laban para sa kalinawan at pag-unawa. Bagaman hindi laging posible, ang mga talata ay dapat mangyari kung saan may ilang pagbabago sa paksa o sub-paksa o ilang pagbabago sa paraan ng pagtalakay sa isang paksa.
Sa isang buong pahinang may single spacing ng pagsulat, humanap ng hindi bababa sa isa hanggang apat na paghahati ng talata—walang anuman na mahiwaga tungkol sa average na iyon kaya huwag itong ituring na parang batas. Tingnan lamang muli ang mga mahabang talata, at suriin ang posibilidad ng mga paghahati ng talata.
Pahalagahan ko ang iyong mga saloobin, reaksyon, at kritisismo tungkol sa kabanatang ito: ang iyong tugon—David McMurrey.
