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 8: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 10: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 9: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 1: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 6: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 ever-evolving market, businesses must adapt swiftly to remain competitive and meet the needs of a fast-paced digital economy. Among the various business strategies available, digital transformation, customer-centricity, and sustainability have emerged as top priorities. Let’s explore why these strategies are critical for busine...
The Cisco Certified Network Associate (CCNA) certification is a pivotal credential for networking professionals, validating your skills in networking fundamentals, security, automation, and programmability. Preparing for the CCNA exam can be challenging, but with the right strategy, resources, and mindset, you can successfully achieve this certific...
The CEO/CIO's Guide to Architecting AI: Vision to Value in Minutes Introduction to Architected AI Artificial intelligence (AI) is becoming part of our life at an unprecedented pace. As CEOs and CIOs grapple with how to leverage this powerful technology to drive strategy and enhance operations, the concept of Architected AI becomes importa...

 



Upcoming Live Webinars




 

Copyright 2006-2024 by Modern Analyst Media LLC