Title :
What part writer? What part programmer? A survey of practices and knowledge used in programmer writing
Author :
Bottomley, Christina
Author_Institution :
Dept. of Tech. Commun., Univ. of Washington, USA
Abstract :
There are few resources geared to technical writers working on documentation for software developers. This paper presents the results of online surveys and telephone interviews that cover the experience, technical knowledge, and practices of technical writers in this area, with a large percentage of respondents who are Microsoft employees. Respondents value strong writing skills and the ability to learn quickly and continuously, with the amount and type of knowledge needed being specific to the subject area and audience for their work.
Keywords :
application program interfaces; software engineering; system documentation; API documentation; Microsoft employees; SDK documentation; programmer writing; software developer documentation; technical knowledge; technical writing; Application software; Computer languages; Documentation; Java; Professional communication; Programming profession; Robustness; Telephony; Visual BASIC; Writing;
Conference_Titel :
Professional Communication Conference, 2005. IPCC 2005. Proceedings. International
Print_ISBN :
0-7803-9027-X
Electronic_ISBN :
0-7803-9028-8
DOI :
10.1109/IPCC.2005.1494255