Linux Today: Linux News On Internet Time.
Search Linux Today
Linux News Sections:  Blog -  Developer -  High Performance -  Infrastructure -  IT Management -  Security -  Storage -
Linux Today Navigation
LT Home
Preferences
Contribute
Link to Us
Search
Linux Jobs

Linux Today
Enterprise Linux Today
Apache Today
JustLinux.com
Linux Planet
PHPBuilder
All Linux Devices
Technology Jobs

JustTechJobs.com

LinuxToday Newsletters
Server Daily
IT Management Daily
Subscribe News
Subscribe PR
Subscribe Security

internet.com
Internet News
Small Business

Advertise
Newsletters
Tech Jobs
E-mail Offers

 






Current Newswire:

Raspberry Pi benchmarked against Beagleboard, low price is long term

20 popular Ubuntu Linux apps you may want to try

A Selection of the Very Best Open Source Tutorials and Tools

Android Ice Cream Sandwich ported to x86 tablets, netbooks and notebooks

SECURITY: Google Chrome 17 Improves Security

How to read a CSV file in Perl?

Red Hat Brings Gluster to Amazon Cloud

New Linux kernel fixes power-saving issues

Using Wii remote with Android Device- Taking Gaming to the Next Level

Commercial Support now available for the open-source NGINX Web server



Applications Management Engineer Sr (NYC)
Next Step Systems
US-NY-New York

Justtechjobs.com Post A Job | Post A Resume
:Shedding commercial attitudes towards documentation
Shedding commercial attitudes towards documentation
Nov 22, 2009, 12 :03 UTC (6 Talkback[s]) (5246 reads)

(Other stories by Bruce Byfield)

"Attitudes to writers (and why they deserve them)

"Part of the problem is that technical writers are held in low regard. There is a simple reason for this reputation: Most technical writers know nothing about technology, and the documentation they produce is worthless. The average technical writer is an English major, and is as apt to be attached to the marketing department of a company as to development or quality assurance. In other words, they have little feel for technology, and are encouraged to think of what they produce as a cosmetic extra rather than a necessity.

"Of course, technical writers could overcome these handicaps if they wanted. I have an English degree myself, yet I had few problems finding work because I realized early that I needed an expert understanding of what I wrote about.

"But this is a minority opinion."

Complete Story

Related Stories:
Linux Bug #1: Bad Documentation (part 2)(Nov 20, 2009)
What Does a User Cost?(Nov 19, 2009)
Providing useful feedback(Nov 19, 2009)
Linux Bug #1: Bad Documentation(Nov 18, 2009)
Great Documentation Is Key to Open Source Success(Nov 16, 2009)


Index Mode   |   Flat Mode   |   Thread Mode   |   Thread Flat  
  Talkback(s) Name  and Date
And it isn't anyhow inherent in deve ...   This is a new curse.   
Rainer Weikusat
Nov 22, 2009, 13:05:22
 
> Enter the> Windows-tradition, where pe ...   Re: This is a new curse.   
Robert
Nov 22, 2009, 18:12:22
 
Calling traditional Unix documentation g ...   Re: This is a new curse.   
Charles Hixson
Nov 22, 2009, 20:39:49
 
> Calling traditional Unix documentation ...   Re: Re: This is a new curse.   
Rainer Weikusat
Nov 22, 2009, 21:20:39
 
Calling traditional Unix documentation g ...   Re: This is a new curse.   
grep
Nov 23, 2009, 13:40:11
 
"Enter the Windows-tradition, where peop ...   Re: & Re: Re: This is a new curse.   
Bernard Swiss
Nov 23, 2009, 22:53:00
 
  Home | Search Talkbacks | Customize View    Top of Page  



Enter your comments below:

* Your Name:

* Your Email Address:

* Subject:

CC: [will also send this talkback to an E-Mail address]

* Comments:

Tags allowed:<I>,<B> and <U>. See our talkback-policy for more about talkback content.

Fields marked with * are required!

..............................




All times are recorded in UTC.
Linux is a trademark of Linus Torvalds.
Powered by Linux, Apache and PHP