Linux Today: Linux News On Internet Time.
Search Linux Today
search.internet.com
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

Become a Marketplace Partner

internet.commerce
Be a Commerce Partner














The Linux Channel at internet.com
Linux Today
Enterprise Linux Today
Apache Today
JustLinux.com
Linux Planet
PHPBuilder
All Linux Devices
Technology Jobs

JustTechJobs.com

LinuxToday Newsletters
Subscribe News
Subscribe PR
Subscribe Security

internet.com
IT
Developer
Internet News
Small Business
Personal Technology

Search internet.com
Advertise
Corporate Info
Newsletters
Tech Jobs
E-mail Offers

 







Current Newswire:

Ksplice debuts zero downtime service for Linux

BM Ups Its Processor Power to 7

KDE.org Relaunched for Software Compilation 4.4

The application is the new the operating system

Linux can compete with the iPad on price, but where’s the magic?

The Bruno Knaapen Technology Learning Center is Established

Anjal: GNOME's Evolution for Netbooks

Linux Mint 8 KDE Community Edition

Open source means freedom from 'anti-features'

GTalX - Google Voice Chat has arrived in Ubuntu 9.10 (Karmic)




UNIX Systems Administrator (IL)
Next Step Systems
US-IL-Chicago

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]) (3624 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


The Network for Technology Professionals

Search:

About Internet.com

Legal Notices, Licensing, Permissions, Privacy Policy.
Advertise | Newsletters | E-mail Offers