×

Announcing: Slashdot Deals - Explore geek apps, games, gadgets and more. (what is this?)

Thank you!

We are sorry to see you leave - Beta is different and we value the time you took to try it out. Before you decide to go, please take a look at some value-adds for Beta and learn more about it. Thank you for reading Slashdot, and for making the site better!

Comments

top

Best Practices For Process Documentation?

Henry_Doors Not about tools (mostly) (370 comments)

As others have said this isn't principly about tools, but about finding a simple and effective ways to extract and record the processes.

Don't get hung up on formal process notations unless you are planning to turn them into software / workflows.

I have done some of my most effective work with pen & paper / flipcharts. For documenting more formally Visio / Smartdraw or other simple diagramming software will do.

Techniques: soft systems for the big picture, use cases to identify processes and actors, activity diagrams with swimlanes for the actual processe.

Agree that somone outside of the process should be lead the documantation as they can ask the dumb questions.

Don't try and document all proceses - use a riak assesment ot identify key processes.

As for keeoping the documentation up to date -how often do the processes change? If they do change as part of a project ensure the project is responsible for updating the documenation

Once models are signed off make sure they are available to those who need them. If the only person who knows which folder they are in goes under a bus you have the same problem!

Good Luck!

more than 6 years ago

Submissions

Henry_Doors hasn't submitted any stories.

Journals

Henry_Doors has no journal entries.

Slashdot Login

Need an Account?

Forgot your password?