Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  General  Technical writer
Previous Previous
 
Next Next
New Post 9/30/2009 8:51 PM
Unresolved
User is offline Iris
3 posts
No Ranking


Technical writer 

Hello, I am new to this forum and also this field. Can some one tell me what are the primary functions of a tech writer? By surfing the net, i have understood that Tech writers write developer manuals. when you say devolopers manuals, what do they mean? are there any samples/templates that you know of? what is the difference between func doc and dev doc?

 
New Post 10/1/2009 9:34 AM
User is offline Tony Markos
493 posts
5th Level Poster


Re: Technical writer 

Iris:

I have significant experience both as a Tech Writer and a BA.   There is a difficulty in answering your question: What, logically, a Tech Writer should be focused on and what he/she typically actually devotes most of his/her work energies to are most often two entirely different things.    This is not a "knock" against Tech Writers; the exact same issue pertains to BAs, SA, QAs, etc., etc.

I will only address what should be done.  The primary goal of a software Technical Writer should be to come up with a comprehensive, integrated understanding of the system's essential functions (i.e., business functions \  processes that exist, irregardless of any implementation consiserations) and - especially - how those functions interrelate (typically, the data flows between them).   Such is also the primary goal of a BA, but typically, the BA works to a higher level of abstraction than a TW (i.e, the BA is often most focused on the "bigger picture", while the TW is more grounded in the details.)

Difference between a functional doc and a development doc?     These mean whatever your organization says they mean.   Simular to your question, recently on the Requirements Engineering listserv, someone asked "What is the difference between a business requirement and a functional requirement".  This is a very basic question, and there are some very knowledgable people contributing to that listserv.  However, after a couple of weeks of discussion, no agreement was reached.  As a matter of fact, just yesterday, I reasked the question, and there still is no agreement:  Alot of well thought out ideas - but no agreement.  

You will find the same thing regarding your question about the difference between a functional doc (which can also be called a functional spec, functional requirements spec, a systems requirements spec, a systems functional requirements spec, etc, etc, etc) and a development doc (which can also be called a design spec, a functional spec, a technical spec, etc, etc, etc)  (Do yourself a hugh favor:  Don't listen to those who imply that there is some universally accepted definition for these, or other simular artifacts.)

Tony

 

 

 
New Post 12/15/2009 10:45 PM
User is offline katkaif
3 posts
No Ranking


Re: Technical writer 

nice topic

 
Previous Previous
 
Next Next
  Modern Analyst Forums  Business and Sy...  General  Technical writer

Community Blog - Latest Posts

Is Agile a reason to avoid documentation? I bet this question shows up again and again while working with product requirements. On one side, we have got long specifications, complicated diagrams, mystical technical design, too many prototypes and pretty obvious for engineers user guides (do we really need so much?). On the other side, can we actual...
The cloud-native application development has helped enterprises all around the globe reduce time-to-market, enhance performance, and develop agility and flexibility. Several enterprises are achieving these results by migrating their systems or traditional monolithic applications to the cloud. But to gain from the real benefits of cloud technology, ...
So you’ve found the perfect time and place to study and you’re ready to finally get some work done. You’ve pulled out your laptop, your textbook, and your notes, and four different highlighters. After five minutes of reading your textbook, you start zoning out and thinking about puppies. Then, you go on Tumblr and look at cut...

 



Upcoming Live Webinars




 

Copyright 2006-2022 by Modern Analyst Media LLC