• Post Reply Bookmark Topic Watch Topic
  • New Topic
programming forums Java Mobile Certification Databases Caching Books Engineering Micro Controllers OS Languages Paradigms IDEs Build Tools Frameworks Application Servers Open Source This Site Careers Other Pie Elite all forums
this forum made possible by our volunteer staff, including ...
Marshals:
  • Campbell Ritchie
  • Ron McLeod
  • Rob Spoor
  • Tim Cooke
  • Junilu Lacar
Sheriffs:
  • Henry Wong
  • Liutauras Vilda
  • Jeanne Boyarsky
Saloon Keepers:
  • Jesse Silverman
  • Tim Holloway
  • Stephan van Hulst
  • Tim Moores
  • Carey Brown
Bartenders:
  • Al Hobbs
  • Mikalai Zaikin
  • Piet Souris

Rufus:Who is tech writer?

 
Ranch Hand
Posts: 898
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator
[quote ] Originally posted by Rufus BugleWeed in
http://www.javaranch.com :
[/quote ]
Fluery claims it written by the developers. Which he states is better than a team of tech writers who really don't know the product they are writing about it. I'm not aurguing this point, I think well managed technical writers can add a lot to a document.
[/quote ]
I was curious already some time from the point of view of interesting job.
How interesting is tech writer?
Always getting to the NEW roots of something without lingering there for much time?
First writing technical documentation then re-editing it to a book? Or it is impossible?
How it is possible to write technical documentation without being a developer (never thought about it in such a way)?
Who is eligible for such kind of job?
Why aren't developers hired for doing it?
[ January 04, 2003: Message edited by: G Vanin ]
 
Ranch Hand
Posts: 1551
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator

How interesting is tech writer?


Beauty is in the eyes of the beholder. My newphew wants to be a policeman. I think dealing with trouble makers all day would be a horrible job.

Always getting to the NEW roots of something without lingering there for much time?


In general, seems to me to always be keeping up w/o making as good a salary as a developer.

First writing technical documentation then re-editing it to a book? Or it is impossible?


Looks like many are skipping the writing of the technical documentation and going straight to the book. This is how many are making money in open source.

How it is possible to write technical documentation without being a developer (never thought about it in such a way)?


I have written documentation to have it reworked by a technical writer. The TW cleaned it up and put it in the repository with tools I don't know.


Who is eligible for such kind of job?


Anybody...


Why aren't developers hired for doing it?


Many technical people are not word, languare, writing inclined. This activity is not their strength.
I R software engineer.
I am devoper.
I am progammar/annalyst.
becomes
I write code.
 
Ranch Hand
Posts: 346
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator

Originally posted by G Vanin:
[quote ] Originally posted by Rufus BugleWeed in
http://www.javaranch.com :
[/quote ]
Fluery claims it written by the developers. Which he states is better than a team of tech writers who really don't know the product they are writing about it. I'm not aurguing this point, I think well managed technical writers can add a lot to a document.
[/quote ]
I was curious already some time from the point of view of interesting job.
How interesting is tech writer?
Always getting to the NEW roots of something without lingering there for much time?
First writing technical documentation then re-editing it to a book? Or it is impossible?
How it is possible to write technical documentation without being a developer (never thought about it in such a way)?
Who is eligible for such kind of job?
Why aren't developers hired for doing it?
[ January 04, 2003: Message edited by: G Vanin ]


According to Tim OReilly its process where the tech writer becomes proficient in the subject and the coder becomes procifient in tech writing as a partnership in getting the user manual or other tech writing produced.
I tend to agree with Him..
But I have alos found that the more successfull Java Programers and Consultants are the ones that do both coding and tech writing..
 
Guennadiy VANIN
Ranch Hand
Posts: 898
  • Mark post as helpful
  • send pies
    Number of slices to send:
    Optional 'thank-you' note:
  • Quote
  • Report post to moderator

Originally posted by Rufus BugleWeed:

Many technical people are not word, languare, writing inclined. This activity is not their strength.
I R software engineer.
I am devoper.
I am progammar/annalyst.
becomes
I write code.


I have got it. I am thinking about with whom I am commuincating at JR
 
So it takes a day for light to pass through this glass? So this was yesterday's tiny ad?
Thread Boost feature
https://coderanch.com/t/674455/Thread-Boost-feature
reply
    Bookmark Topic Watch Topic
  • New Topic