Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  General  Technical writer
Previous Previous
 
Next Next
New Post 9/30/2009 7: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 8: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 9: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

Fabricio Laguna talks Business Analysis and AI
I recently connected with Fabricio Laguna, aka The Brazilian BA. Fabricio is a passionate and pioneering business analyst from Brazil. During our conversation, we had a thought-provoking discussion on how artificial intelligence stands to shape the field of business analysis in the years ahead. While AI promises to transform many aspects of busines...
Business Architecture, Ontology and More with Terry Roach
It's been a privilege meeting Terry Roach, a visionary in the field of enterprise architecture and business architecture. Terry's insights into the evolution of business models, the importance of ontology in architecture, and the potential of AI to shape our future were not only thought-provoking but also a reflection of his extensive exper...
Today I had the pleasure of chatting to Jignesh Jamnadas, Chief Operations Officer at Mosaic, about his Blueprints for Success. As a Senior Finance and Operations Executive, Jigs (as he is known to many) has a holistic understanding of all facets of business and a flair for managing both people and processes. Having worked with Jigs, I was struc...

 



Upcoming Live Webinars




 

Copyright 2006-2024 by Modern Analyst Media LLC