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

In today's dynamic business environment, mastering effective business analysis techniques is crucial for organizations aiming to achieve sustainable growth and competitive advantage. Business analysis involves the systematic evaluation of business processes, requirements, and strategies to uncover insights that drive informed decision-making. T...
For many years now, a lot of people have found it difficult to identify the difference between Sankey diagrams and parallel sets. The two have made headlines, given that most people find it challenging to note what makes them different from each other. What remains to be undeniable is the fact that the Sankey diagram is among the top data visualiza...
Hosted by Deirdre Caren on Agora Insight's Blueprints for Success - Business Architecture and AI In our recent conversation with Joseph Edward, we explored the transformative power of business architecture (BA) and technology as tools for uplifting communities. Joseph, with his rich background spanning from education to IT leadership, shared...

 






 

Copyright 2006-2024 by Modern Analyst Media LLC