Comments on: Technical Specifications and System Documentation Can Take Different Forms https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/ We'll Help You Start Your Business Analyst Career Tue, 25 May 2010 03:44:19 +0000 hourly 1 https://wordpress.org/?v=6.6.2 By: Colette Blanton https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/comment-page-1/#comment-429347 Tue, 25 May 2010 03:44:19 +0000 http://www.bridging-the-gap.com/?p=2234#comment-429347 I too would love to know more about the documentation a Business Analyst would provide the team versus the Software Architect. Furthermore, how the two roles compliment each other or perhaps conflict?

]]>
By: steve blais https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/comment-page-1/#comment-429346 Tue, 19 Jan 2010 17:19:09 +0000 http://www.bridging-the-gap.com/?p=2234#comment-429346 I am wondering how many business analysts will actually challenge the existing corporate standards for documentation, even though those standards might be outdated and perhaps even essentially useless? How many business analysts skip the confrontation aspects of attempting to get standards for documentation altered and simply work around them? And, how many business analysts simply follow the standards without thinking?

]]>
By: Laura (Brandau) Brandenburg https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/comment-page-1/#comment-429345 Tue, 19 Jan 2010 13:43:57 +0000 http://www.bridging-the-gap.com/?p=2234#comment-429345 Thanks Durga, Leslie, and Jarett, Thanks for all your input. I can see we have some very different practices here. This is interesting.

I have typically worked on projects with less in the way of formality and without a system architect role on every project. So the use case typically accompanied a broader system design document with the approach outlined for the project. Together these two documents provided the input the developers needed too begin to write code. I think I’ve also been working with fairly senior level developers and they are able to break down the functional requirements into system requirements and begin to write code. Typically I also deliver wireframes with use cases. So the requirements are fairly detailed, in terms of fields, logic, and business rules before they end up in the hands of the developers.

I’d be interested to hear more from other readers as well about the contents of the technical specs you hand off to the development team and how much of the detail you deliver vs. a solutions/systems architect you might be working with?

Laura

]]>
By: Durga Patil https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/comment-page-1/#comment-429344 Tue, 19 Jan 2010 05:41:06 +0000 http://www.bridging-the-gap.com/?p=2234#comment-429344 Hi Laura
Basically I go for separate documents considering the audience I am writing for. May be it’s because I have worked on projects where domain (functional knowledge) plays a vital part.

Basically usecase case will only tell “what to implement”, the functionality. These usecases can be embedded into the FRS. The end audience of a use case is the solution architect or system architect, QA team and not developers. You cannot expect dot net or java developer to understand functional terms.

Functional req after analysis is converted into prototypes, screen level description, a level which completely described “how to implement” the functionality. The end audiences here are the developers.

System documentation will include the details of finished system you won’t be adding the crude prototypes but will be adding the final screen shots of the finished systems. This document will tell user ‘what is implemented”. The end audiences here, as u have correctly mentioned are business analysts, project managers, and product owners.

]]>
By: leslie munday https://www.bridging-the-gap.com/technical-specifications-and-system-documentation-can-take-different-forms/comment-page-1/#comment-429343 Mon, 18 Jan 2010 22:28:02 +0000 http://www.bridging-the-gap.com/?p=2234#comment-429343 I see 4 main purposes for use cases and their derivatives:
– the use case storyboard is the introduction to the user guide.
– the use case realization is the introduction to system design.
– the test case may be use cases with test data added.
– the use case itself, which is a means to identifying the requirements.

That’s a lot of re-use from a single artifact.

Leslie.

]]>