Forums for the Business Analyst

 
  Modern Analyst Forums  Business and Sy...  Business Proces...  Technical Writer - Where do i start?
Previous Previous
 
Next Next
New Post 10/22/2009 7:36 AM
Unresolved
User is offline Iris
3 posts
No Ranking


Technical Writer - Where do i start? 

I have recently joined an organization where Business analysis has been completed (when i say business analysis, this includes the workflow with some flow charts and use cases). From here i need to produce a technical document, which means to recognize what will be the flow of the app, what are the data elements that is relevent to each page,. My client do not have any current system (like any legacy) system to guide me through.

Please help me how to reconize data elements, design screen flow etc from this document. Where do i start?

I am new to this field and any help is much appreciated.

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


Re: Technical Writer - Where do i start? 

Hi Iris:

What do you mean by the flow of the app?  Do you mean the flow of data, or the sequence of activities accomplished by the application, or both?  

It sounds like you need to  understand how data logically flows through the system so that you can then use this understanding to properly organize your document to discuss data elements per screen.  If such is the case, only data flow diagrams systematically address data flows.   You don't need involved data flow diagrams; often just rough cut diagrams showing the primary information flows will go a long ways towards helping you proper structure your document.    I have ample experience as a Tech Writer, and this is how I have done it.

Tony 

 

 
New Post 10/22/2009 8:50 AM
User is offline Chris Adams
323 posts
5th Level Poster






Re: Technical Writer - Where do i start? 

 Iris wrote
 

I have recently joined an organization where Business analysis has been completed (when i say business analysis, this includes the workflow with some flow charts and use cases). From here i need to produce a technical document, which means to recognize what will be the flow of the app, what are the data elements that is relevent to each page,. My client do not have any current system (like any legacy) system to guide me through.

Please help me how to reconize data elements, design screen flow etc from this document. Where do i start?

I am new to this field and any help is much appreciated.

Iris,

Let me try and clarify where you are at the moment.  It sounds like you have a Business Requirements Document or at least some of the information that might be included in one including, process flows and use cases. 

Are these system process flows and system use cases?  Meaning do they describe the system and what is should support, or do they describe the business / business processes and you are supposed to define the system that will support the business process?  Do you have a list of System Requirements..."The system shall..."?

 


Chris Adams
Core Member – ModernAnalyst.com
LinkedIn Profile
 
New Post 10/22/2009 12:42 PM
User is offline Iris
3 posts
No Ranking


Re: Technical Writer - Where do i start? 

Are these system process flows and system use cases?  Meaning do they describe the system and what is should support, or do they describe the business / business processes and you are supposed to define the system that will support the business process?  Do you have a list of System Requirements..."The system shall..."?

No they are not system process flows or system use cases, they are business process flows and business use cases. Using this doc, i am supposed to define system that will support the business process. I do not have any systems requirements as i have to cfreate this.

thanks for your time.

 

 
New Post 10/23/2009 5:05 PM
User is offline KJ
243 posts
6th Level Poster


Re: Technical Writer - Where do i start? 

Iris,

These business flows and business use cases need to be translated into system requirements. From a business flow perspective its easy to decide which of the activities need to be automated. This is Tony Markos' famous partitioning perspective: in the old DFD world we used to partition some process elements within the automation boundary. You then use these automated activities and create system use cases and system requirements. Sometimes its best to first create the system requirements as these govern the behaviour of the system; and system use cases describe how the system behaves when you, the user, interacts with the system.

warm regards,

K

 
Previous Previous
 
Next Next
  Modern Analyst Forums  Business and Sy...  Business Proces...  Technical Writer - Where do i start?

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...

 






 

Copyright 2006-2024 by Modern Analyst Media LLC