requirement documentation

An Exercise in Documenting Current State: Reddit and the BDD

Introduction “Let’s be honest; someone knows how all this stuff works, right?” This is a phrase that may come up in many, many projects in several different SDLC atmospheres. Companies, over years and years of IT innovation, restructure, re-programming, retrofits, etc., contain a cobweb of functionality and features of many …

Read More

Tell a Story Through Your Requirements, Part I

Most of the projects that we work on here at Seilevel involve producing some sort of coherent documentation to describe what a given piece of software needs to be able to do and how it will work. Of course, software requirements are a crucial part of this documentation, but by …

Read More

Making Requirement Artifacts Consumable

One of the things that I’ve noticed that some business analysts have a tendency to do is to try and get as much information onto one page as possible. I can understand that desire, wanting to keep all relevant information together.  For example, when creating a process flow, there is …

Read More

Business Analyst Tip: Context Matters

In an episode of “The Big Bang Theory”, Leonard arrives home with his arms full of food and says “I hope you’re hungry” to which Sheldon responds “Interesting. A friendly sentiment in this country, cruel taunt in the Sudan. It’s a lesson in context.”  The humor may be dark, but …

Read More

What 5 measures can you use as personal objectives?

What 5 measures can you use as personal objectives? On the modern analyst forum, Andrea asked the question “I have been asked to come up with 5 personal “Management Business Objectives” for myself in my position as Business Systems Analyst. I need to have them by the end of January …

Read More

Business Analyst Tip: The Format Painter

Like many of us, I’ve been known to mumble disparaging remarks about Microsoft under my breath while using their tools. But, I have to say there is at least one thing they did right – the format painter. I run into enough people who don’t know about this that I think …

Read More

Glossaries, Philosophers, and Business Analysts

When I was a senior in high school, my English teacher made us read “Politics and the English Language,” an essay by George Orwell. The essay points out that much contemporary writing is, in general, imprecise and ugly. One of the main reasons for this, he says, is that many …

Read More

Requirements Training: Consuming our Deliverables

Business Objectives defined…check. Organizational Chart created…check. Process Flows defined…check. System Context Diagram confirmed…check. Requirements written…check. Everything handed off to development…check. So, we’re done…right?  Nope, the fun is just getting started! We spend a lot of time working with our business sponsors, the subject matter experts, and the project manager to …

Read More