Teknik Yazar - Technical writer

Teknik Yazar

Meslek
Eş anlamlı	Teknik muhabir, Teknik editör, Dokümantasyon yazarı
Telaffuz
Faaliyet sektörleri	Yazılım , Teknoloji , İmalat
Açıklama
Yeterlilikleri	Analitik beceriler Eleştirel düşünme
İstihdam alanları	STK'lar , Şirketler , İş
İlgili işler	Editör , speechwriter , Senaryo , Redaktör , Kopya editörü

Bir teknik yazar görevi en iyi bilgi transferini ve anlama kolaylaştırır herhangi bir ortamda aracılığıyla, iki veya daha fazla taraf arasında bilgi aktarımı için bir profesyonel bilgi iletişimci. Teknik yazarlar, çeşitli dağıtım ortamları (elektronik, basılı, görsel-işitsel ve hatta dokunmatik) aracılığıyla bilgi araştırır ve oluştururlar. Örnek bilgi türleri, çevrimiçi yardım , kılavuzlar, teknik incelemeler , tasarım özellikleri , proje planları ve yazılım test planlarını içerir. E-öğrenmenin yükselişiyle birlikte , teknik yazarlar giderek daha fazla çevrimiçi eğitim materyali oluşturmaya dahil oluyorlar.

Göre Teknik İletişim Derneği (STC):

Teknik yazı bazen kompleksi basitleştirmek olarak tanımlanır. Bu kadar özlü ve aldatıcı derecede basit bir tanımın özünde, bir düzeyde insan çabasının neredeyse her alanına hitap eden bir dizi beceri ve özellik vardır. Daha geniş teknik iletişim alanının önemli bir alt kümesi olan teknik yazı, karmaşık bilgileri bir görevi veya hedefi gerçekleştirmek için ihtiyacı olanlara iletmeyi içerir.

Başka bir deyişle, teknik yazarlar ileri teknik kavramları alır ve bunları hedeflenen kitleye mümkün olduğunca açık, doğru ve kapsamlı bir şekilde ileterek, çalışmanın kullanıcılarına erişilebilir olmasını sağlar.

Kurt Vonnegut teknik yazarları şöyle tanımladı:

...yazılarında kendileri hakkında neredeyse hiçbir şey ortaya koymayacak şekilde eğitildiler. Bu, yazarların dünyasında onları ucube yapar, çünkü o dünyadaki diğer mürekkep lekeli zavallıların neredeyse tamamı okuyucuya kendileri hakkında çok şey anlatır.

Mühendisler, bilim adamları ve diğer profesyoneller de teknik yazıya dahil olabilirler ( gelişimsel düzenleme , redaksiyon , vb.), ancak materyalleri geliştirmek, düzenlemek ve biçimlendirmek için profesyonel teknik yazarları işe almaları daha olasıdır ve onlara bilgi sağlamanın en iyi yollarını tavsiye ederler. seyirciler.

mesleğin tarihi

Göre Teknik İletişim Derneği (STC), meslekleri teknik iletişim ve teknik yazı ilk etrafında başvurulan edildi Dünya Savaşı teknik dokümanlar askeri amaçlarla bir zorunluluk haline geldiğinde,. İş unvanı ABD'de II. Dünya Savaşı sırasında ortaya çıktı, ancak 1951'e kadar ilk "Yardım Aranıyor: Teknik Yazar" reklamı yayınlanmadı. Aslında, 2010 yılına kadar ABD Çalışma İstatistikleri Bürosu'nun Mesleki İstihdam El Kitabına "Teknik Yazar" unvanı eklenmedi. 1940'lar ve 50'ler boyunca, ordu için belgeler üretmek üzere teknik iletişimciler ve yazarlar tutuldu ve bunlar genellikle ayrıntılı talimatlar da içeriyordu. yeni silahlar. Diğer teknik iletişimciler ve yazarlar, bu süre zarfında geliştirilen yeni teknolojiler için dokümantasyon geliştirmeye dahil oldular. O'Hara'ya göre:

Savaş, bilimsel ve teknolojik ilerlemenin en önemli itici gücüydü. ABD Ordusu Tabip Birlikleri Panama ormanlarında sıtmayla savaştı, Kimyasal Birlik patlayıcılar ve zehirli gazlarda (ve bunlara karşı savunmalarda) kimyasal ilerlemeleri zorladı, Manhattan Mühendisler Birliği Bölgesi fizik anlayışında kelimenin tam anlamıyla kuantum sıçramaları yaptı ve Hava Kuvvetleri havacılık tasarımına öncülük etti.

Mesleğin başlangıcında, çoğu teknik yazar, diğer yazarlardan oluşan bir ekiple bir ofis ortamında çalıştı. Bugünkü teknik yazarlar gibi, birincil araştırma yaptılar ve bilgilerinin doğru olduğundan emin olmak için konu uzmanlarıyla bir araya geldiler. İkinci Dünya Savaşı sırasında, teknik yazarlar için en önemli özelliklerden biri, belgeler için katı hükümet şartnamelerini takip etme yetenekleriydi. Savaştan sonra, bilgisayar gibi yeni teknolojilerin yükselişi, teknik yazarların "kullanım kılavuzları, hızlı başvuru kılavuzları, donanım kurulum kılavuzları ve hile sayfaları" üreterek diğer alanlarda çalışmasına izin verdi. Savaştan sonraki dönemde (1953-1961), teknik iletişimciler (teknik yazarlar dahil) kendi alanlarını "profesyonelleştirmek" ile ilgilenmeye başladılar. Malone'a göre, teknik iletişimciler/yazarlar bunu profesyonel örgütler oluşturarak, meslek için "uzmanlaşmış bir bilgi birikimi" geliştirerek, teknik iletişimcilere etik standartlar dayatarak, alandaki pratisyenleri sertifikalandırma hakkında bir konuşma başlatarak ve eğitim programlarını akredite etmek için çalışarak yaptılar. alan içerisinde.

Meslek büyümeye devam etti – O'Hara'ya göre, teknik yazarlar da dahil olmak üzere yazarlık/editörlük mesleği, 1994 ve 2005 yılları arasında pozisyonlarda %22'lik bir artış yaşadı. Günümüzün teknik yazarları çeşitli bağlamlarda çalışıyor. Birçok teknik yazar, VPN kullanarak uzaktan çalışır veya Skype veya Zoom gibi görüntülü telefon platformları aracılığıyla ekipleriyle iletişim kurar . Diğer teknik yazarlar bir ofiste çalışır, ancak belgeleri çevrimiçi olarak depolayan karmaşık içerik yönetim sistemleri aracılığıyla ekipleriyle içerik paylaşır . Teknik yazarlar, resmi raporlar, dahili belgeler, teknik ekipman talimatları, yazılım veya sistemler içindeki gömülü yardım veya diğer teknik belgeler üzerinde çalışabilirler. Teknoloji ilerlemeye devam ettikçe, teknik yazarlar için olanaklar dizisi genişlemeye devam edecek. Birçok teknik yazar, mobil uygulamalar için teknik belgeler veya mobil veya web uygulamaları içinde oluşturulmuş yardım belgeleri oluşturmaktan sorumludur. Yalnızca elde tutulan bir cihazda görüntülenecek içerik oluşturmaktan sorumlu olabilirler; çalışmalarının çoğu, geçmişin teknik belgeleri gibi basılı bir kitapçıkta asla yayınlanmayacak.

Yetenek Seti

Sağlam araştırma, dil, yazma ve gözden geçirme becerilerine ek olarak, teknik bir yazar aşağıdaki becerilere sahip olabilir:

Teknik bir yazar, becerilerini teknik olmayan içerik üretiminde, örneğin üst düzey tüketici bilgileri yazmada uygulayabilir . Teknik bir yazar genellikle bir konu uzmanı (KOBİ) değildir, ancak KOBİ'lerle görüşür ve teknik olarak doğru içeriği yazmak ve derlemek için gerekli araştırmayı yürütür. Teknik yazarlar, konuyu tam olarak anlamak için hem birincil hem de ikincil araştırmayı tamamlar.

özellikleri

Uzman teknik yazarlar, teknik materyali kısa ve etkili bir şekilde oluşturma, özümseme ve aktarma yeteneğine sahiptir. Belirli bir alanda uzmanlaşabilirler ancak tanımladıkları ürünleri iyi anlamaları gerekir. Örneğin, API yazarları öncelikle API belgeleri üzerinde çalışırken, diğer teknik yazarlar elektronik ticaret , üretim, bilimsel veya tıbbi malzeme konusunda uzmanlaşmıştır .

Teknik yazarlar birçok kaynaktan bilgi toplarlar. Bilgi kaynakları genellikle geliştiricilerden pazarlama departmanlarına kadar değişebilen bir organizasyona dağılmıştır.

Markel'e göre, faydalı teknik belgeler sekiz özellik ile ölçülür: "dürüstlük, netlik, doğruluk, anlaşılırlık, erişilebilirlik, özlülük, profesyonel görünüm ve doğruluk." Teknik yazarlar, bu sekiz özelliği karşılayan etkili belgeler oluşturmak için dikkatli araştırmalarını kullanmaya odaklanırlar.

Roller ve işlevler

Etkili teknik belgeler oluşturmak için yazar, belirli bir projenin retorik durumunu oluşturan üç unsuru analiz etmelidir: hedef kitle, amaç ve bağlam. Bunları, okuyucunun ne gördüğünü belirleyen belge tasarımı izler.

Kitle analizi

Teknik yazarlar, okuyucunun kavrayışını en üst düzeye çıkarmak için karmaşık kavramları veya süreçleri basitleştirmeye çalışır. Belirli bir belgenin nihai amacı, okuyucuların ihtiyaç duyduklarını bulmalarına, bulduklarını anlamalarına ve anladıkları şeyi uygun şekilde kullanmalarına yardımcı olmaktır. Bu amaca ulaşmak için teknik yazarlar, kitlelerinin belgeleri nasıl kullandığını ve okuduğunu anlamalıdır. Bir belge projesinin başlangıcındaki bir hedef kitle analizi, belirli bir belge için hedef kitlenin ne gerektirdiğini tanımlamaya yardımcı olur.

Bir izleyiciyi analiz ederken teknik yazar genellikle şunları sorar:

• Hedef kitle kim?
• Demografik özellikleri nelerdir?
• Seyircinin rolü nedir?
• Okuyucu konu hakkında ne düşünüyor?
• Okuyucu gönderen hakkında ne düşünüyor?
• Okuyucu nasıl bir form bekliyor?
• Seyircinin görevi nedir?
• Seyirci neden bu görevi yerine getirmek zorunda?
• İzleyicinin bilgi düzeyi nedir?
• Durumu hangi faktörler etkiler?

Doğru hedef kitle analizi, belge içeriğini, tasarımını ve sunumunu (çevrimiçi yardım sistemi, etkileşimli web sitesi, kılavuz vb.) ve tonu ve bilgi düzeyini şekillendiren bir dizi yönerge sağlar.

Amaç

Teknik bir yazar, bir belgenin neyi başarması gerektiğini anlamak için bir iletişimin amacını (veya işlevini) analiz eder. Bir iletişimin okuyucuları “belirli bir şekilde düşünmeye veya hareket etmeye, bir görevi yerine getirmelerine, bir şeyi anlamalarına yardımcı olmaya, tutumlarını değiştirmeye” vb. ikna etmeyi amaçlayıp amaçlamadığını belirlemek, teknik yazara iletişimlerini nasıl biçimlendirecekleri konusunda yol gösterir. seçtikleri iletişim türü (çevrimiçi yardım sistemi, teknik inceleme, teklif vb.).

Bağlam

Bağlam, okuyucuların iletişimi kullandığı fiziksel ve zamansal koşullardır - örneğin: ofis masalarında, bir üretim tesisinde, yavaş yaz aylarında veya bir şirket krizinin ortasında. Bir durumun bağlamını anlamak, teknik yazara okuyucuların iletişimi nasıl kullandığını anlatır. Bu bilgi, yazarın iletişimi nasıl biçimlendirdiğini önemli ölçüde etkiler. Örneğin, belge küçük bir deniz taşıtındaki kontroller için hızlı bir sorun giderme kılavuzuysa, yazar, kullanım ömrünü artırmak için sayfaları lamine ettirebilir.

Belge tasarımı

Yukarıdaki bilgiler toplandıktan sonra, belge optimum okunabilirlik ve kullanılabilirlik için tasarlanır. Bir uzmana göre, teknik yazarlar teknik iletişimi planlamak ve oluşturmak için altı tasarım stratejisi kullanır: düzenleme, vurgu, netlik, özlülük, ton ve değerler.

Aranjman

Okuyucuların yapılarını, gruplar halinde nasıl birleştiklerini, birbirlerinden nasıl farklı olduklarını, katmanları ve hiyerarşileri nasıl oluşturduklarını görebilmeleri için görsel öğelerin düzeni ve organizasyonu. Düzenlemeyi düşünürken teknik yazarlar, kullanılabilirliği artırmak için başlıkların, listelerin, çizelgelerin ve resimlerin nasıl kullanılacağına bakarlar.

Vurgu

Bir belgenin önemli bölümleri belirginlik veya yoğunluk yoluyla nasıl gösterdiği. Vurgulamayı düşünürken teknik yazarlar, okuyuculara önemli bölümleri, uyarıları, faydalı ipuçlarını vb. yerleştirme, kalınlaştırma, renk ve yazı boyutu kullanarak nasıl gösterebileceklerine bakarlar.

netlik

“Alıcının mesajın kodunu çözmesine, onu hızlı ve eksiksiz bir şekilde anlamasına ve gerektiğinde kararsız tepki vermesine yardımcı olan” stratejiler. Teknik yazar, netliği değerlendirirken, tümü okuyucunun anlamasını engelleyebilecek düşük kontrast oranları, aşırı karmaşık çizelgeler veya grafikler ve okunaksız yazı tipi gibi görsel gürültüyü azaltmaya çalışır.

Özlülük

Tasarımın "görsel yığını ve karmaşıklığı"—örneğin, başlıkların ve listelerin, satırların ve kutuların sayısı, çizimlerin ve veri görüntülerinin ayrıntıları, boyut farklılıkları, süsleme ve metin aralığı. Teknik yazarlar, izleyicilerin belgeleri kolayca kullanabilmesini sağlamak için tüm bu tasarım stratejilerini göz önünde bulundurmalıdır.

ton

Bir belgenin sesi veya hissi. Belge türü ve hedef kitle, iletişimin resmi ve profesyonel mi yoksa hafif ve esprili mi olacağını belirler. Teknik yazarlar, dil seçimine ek olarak, boşluklar, resimler, yazı tipleri vb. kullanarak teknik iletişimin tonunu belirler.

ahlak

Görsel dilin bir belgede ulaştığı güvenilirlik derecesi. Teknik yazarlar, izleyiciler nezdinde güvenilirlik sağlamak için profesyonel ve hatasız belgeler oluşturmaya çalışırlar.

Nitelikler

Teknik yazarlar normalde teknik ve yazma yeteneklerinin bir karışımına sahiptir. Genellikle teknik bir alanda diplomaları veya sertifikaları vardır, ancak gazetecilik, işletme veya diğer alanlarda diplomaları olabilir. Birçok teknik yazar, genellikle teknik iletişim dersleri aracılığıyla önemli ek beceriler öğrendikten sonra, gazetecilik gibi başka bir alandan veya mühendislik veya bilim gibi teknik bir alandan geçiş yapar.

Metodoloji (belge geliştirme yaşam döngüsü)

Teknik bir belge oluşturmak için teknik bir yazar konuyu, amacı ve hedef kitleyi anlamalıdır. Mevcut materyali inceleyerek, KOBİ'lerle görüşerek ve genellikle ürünü fiilen kullanarak bilgi toplarlar. İzleyicileri ihtiyaçlarını ve teknik anlayış düzeylerini öğrenmek için incelerler.

Bir teknik yayının geliştirme yaşam döngüsü, genel ürün geliştirme planıyla koordineli olarak tipik olarak beş aşamadan oluşur:

• Aşama 1: Bilgi toplama ve planlama
• 2. Aşama: İçerik belirtimi
• 3. Aşama: İçerik geliştirme ve uygulama
• 4. Aşama: Üretim
• Aşama 5: Değerlendirme

Belge geliştirme yaşam döngüsü tipik olarak altı aşamadan oluşur (Bu, organizasyondan organizasyona, nasıl takip edildiklerine göre değişir).

1. Kitle profili oluşturma (hedef kitleyi tanımlayın)
2. Kullanıcı görev analizi (hedef kitleye göre görevleri ve bilgileri analiz edin)
3. Bilgi mimarisi (analiz tabanlı tasarım, belge nasıl hazırlanır)
4. İçerik geliştirme (belgeyi geliştirin/hazırlayın)
5. Teknik ve editoryal incelemeler (üst düzey personel-yöneticiler vb. ile inceleme)
6. Biçimlendirme ve yayınlama (belgeyi yayınlama).

Bu, yazılım geliştirme yaşam döngüsüne benzer.

İyi yazılmış teknik belgeler genellikle resmi standartları veya yönergeleri takip eder. Teknik belgeler, ortama ve konu alanına bağlı olarak birçok stil ve biçimde gelir. Basılı ve çevrimiçi belgeler çeşitli şekillerde farklılık gösterebilir, ancak yine de düzyazı, bilgi yapısı ve düzen için büyük ölçüde aynı yönergelere bağlı kalır. Genellikle teknik yazarlar, standart bir stil kılavuzunda açıklanan biçimlendirme kurallarına uyarlar . ABD'de teknik yazarlar genellikle The Associated Press Stylebook veya Chicago Manual of Style (CMS) kullanır. Birçok şirketin, logo kullanımı, marka bilinci oluşturma ve kurumsal tarzın diğer yönleri gibi belirli kurumsal konuları kapsayan dahili kurumsal stil kılavuzları vardır. Teknik Yayınlar Stil Microsoft Manuel bunlar tipik bir örneğidir.

Mühendislik projeleri, özellikle savunma veya havacılıkla ilgili projeler, genellikle sivil uçaklar için ATA100 veya sivil ve savunma platformları için S1000D gibi ulusal ve uluslararası dokümantasyon standartlarını takip eder.

Çevre

Teknik yazarlar genellikle bir yazı veya proje geliştirme ekibinin parçası olarak çalışırlar. Tipik olarak, yazar bir taslağı bitirir ve bunu, doğruluğunu ve eksiksizliğini doğrulamak için teknik bir inceleme yürüten bir veya daha fazla KOBİ'ye iletir . Başka bir yazar veya editör, stillere, dilbilgisine ve okunabilirliğe uygunluğu kontrol eden bir editör incelemesi yapabilir . Bu kişi açıklama isteyebilir veya önerilerde bulunabilir. Bazı durumlarda, yazar veya diğerleri, kullanılabilirlik iyileştirmeleri yapmak için belgeyi hedef kitle üyeleri üzerinde test eder . Nihai bir üretim, yayınlanan ürünün kalitesini ve tek biçimliliğini sağlamak için tipik olarak bir denetim kontrol listesini takip eder.

Kariyer gelişimi

Teknik yazarlar için tek bir standart kariyer yolu yoktur, ancak diğer yazarlar yerine proje yönetimine geçebilirler. Bir yazar, karmaşık projeleri veya küçük bir yazar ve editör ekibini ele alarak kıdemli bir teknik yazar pozisyonuna ilerleyebilir. Daha büyük gruplarda, bir dokümantasyon yöneticisi birden fazla proje ve ekibi yönetebilir.

Teknik yazarlar ayrıca belirli bir teknik alanda uzmanlık kazanabilir ve yazılım kalite analizi veya iş analizi gibi ilgili formlara dalabilirler. Bir alanda uzmanlaşan teknik yazar, teknik yazarlıktan o alanda çalışmaya geçebilir. Teknik yazarlar genellikle belgeledikleri teknolojiler için -sınıf kılavuzları ve e-öğrenme dahil- ve profesyonel eğitmenler ve öğretim tasarımcıları olarak uzmanlaşmak için bazı geçişler için eğitim üretirler.

Yazma becerilerinde uzmanlığa sahip teknik yazarlar, basılı medya veya elektronik medya şirketlerine katılarak potansiyel olarak daha fazla para kazanma veya çalışma koşullarını iyileştirme fırsatı sağlayabilir.

Nisan 2021'de ABD Çalışma Bakanlığı, teknik yazar istihdamının 2019'dan 2029'a tüm meslekler için ortalamadan biraz daha hızlı bir şekilde yüzde yedi büyümesini bekliyordu. Özellikle teknik becerilere sahip adaylar için iş fırsatlarının iyi olmasını bekliyorlar. BLS ayrıca "bilimsel ve teknik ürünlerin" genişlemesinin ve teknik yazarların "Web tabanlı ürün desteğinde" çalışmasına duyulan ihtiyacın artan talebi artıracağını belirtti.

ZipRecruiter'a göre Haziran 2021 itibariyle, Amerika Birleşik Devletleri'nde serbest çalışan bir teknik yazar için ortalama yıllık ücret 70,191 ABD dolarıdır .

Önemli teknik yazarlar

• JR (1975) ve A Frolic of His Own (1994) kitaplarının yazarı William Gaddis , ilk romanı The Recognitions'ın kötü kabulünden sonra Pfizer ve Eastman Kodak gibi şirketlerde on buçuk yıl teknik yazar olarak çalıştı. (1955).
• Gordon Graham , beyaz kağıtlar uzmanı ve eski yazarlık profesörü.
• Dan Jones , üniversite profesörü ve Teknik İletişim Derneği üyesi .
• Zen and the Art of Motorcycle Maintenance: An Inquiry into Values ​​(ZAMM) (1974) kitabının yazarı Robert M. Pirsig , en çok satan kitap üzerinde çalışırken IBM için teknik kılavuzlar yazdı.
• The Crying of Lot 49 (1966), Gravity's Rainbow (1973) ve Mason & Dixon'ın (1997) Amerikalı yazarı Thomas Pynchon , ilk romanı V.'yi (1963) yazdı. 1960'dan 1963'e kadar Boeing .
• Richard Wilbur , Amerikalı şair. Konuşmada bahsettiği gibi Boeing için çalıştı.
• George Saunders , Onuncu Aralık: Öyküler (2013) kitabının yanı sıra diğer kısa öykü koleksiyonları, denemeler ve kısa romanların Amerikalı yazarı, ilk kısa öykü koleksiyonu CivilWarLand in Bad Decline'ı (1996) teknik bir yazar ve jeofizik yazar olarak çalışırken yazdı. Rochester, New York'ta bir çevre mühendisliği firması olan Radian International için mühendis .
• Amy Tan , The Joy Luck Club (1998), The Bonesetter's Daughter (2001) ve eleştirmenlerce beğenilen diğer romanların Amerikalı yazarı . Tan, teknik yazarken kurmaca romanlar yazmaya başladı.
• Ted Chiang , Story of Your Life (1998) ve The Merchant and the Alchemist's Gate (2007) gibi kısa öykülerin Amerikalı yazarı, Temmuz 2002'de yazılım endüstrisinde teknik bir yazardı.
• Amerikalı yazar ve deneme yazarı Marion Winik , 1984-1994 yılları arasında Unison-Tymlabs, Austin, Texas'ta teknik yazar olarak çalıştı.

benzer başlıklar

Teknik yazarlar, teknik iletişimci, bilgi geliştirici , teknik içerik geliştirici veya teknik dokümantasyon uzmanı dahil olmak üzere çeşitli iş unvanlarına sahip olabilir . In Birleşik Krallık ve diğer bazı ülkelerde, bir teknik yazar genellikle denir teknik yazar veya bilgi yazar .

Ayrıca bakınız

• Ortak düzenleme
• Avrupa Teknik İletişim Derneği
• Yazılım belgeleri

Referanslar

Dış bağlantılar

• Teknik yazarlar için standartlar için açıklamalar ve bağlantılar
• Teknik Yazma Eğitim Programları - Los Angeles Chapter, Society for Technical Communication (LASTC)
• ISO/IEC JTC 1/SC 7 ISO/IEC JTC 1/SC 7 - Çalışma Grubu 2, yazılım dokümantasyonu için uluslararası standartlar geliştirir