Tag Archives: documentation

The Greatest Illustration of Writing Accurate Instructions Ever!

For architects, business analysts, programmers, managers, testers, and everyone else. It isn’t easy to do it well…

Posted in Management | Tagged , , , | Leave a comment

Documentation

I’ve written a lot of different kinds of documentation in my career, and I list and describe them here. Some types of documentation are formal, as in manuals written for various phases of a project, but others will be more … Continue reading

Posted in Tools and methods | Tagged , , , , | Leave a comment

Designing and Documenting Inter-Process Communication Links

I’ve touched on the subject of inter-process communication previously here and here, but now that I’m charged with doing a lot of this formally I wanted to discuss the process in more detail. I’m sharing this in outline form to … Continue reading

Posted in Software | Tagged , , , | Leave a comment

Business Process Model and Notation (BPMN 2.0)

Today I was able to complete a thorough power-read of the book Real Life BPMN by Jakob Freund and Bernd Rücker. I’ve performed discovery on, analyzed, characterized, automated, modeled, simulated, documented, controlled, and improved various kinds of customer processes more … Continue reading

Posted in Tools and methods | Tagged , , , , , , | Leave a comment

Project Management Environments I’ve Worked In – Part 1

Most of the work I’ve done in my career has been accounted for on a project basis. I was never an operations guy, my job was always to build or fix something under a particular job code and then go … Continue reading

Posted in Management | Tagged , , , | Leave a comment

Three Plates of Spaghetti

Spaghetti is great for a meal but not so much for code.  I’ve had to deal with three major plates of spaghetti code in my career.  Here’s how they went and what I learned. I got to write all my … Continue reading

Posted in Software | Tagged , , | Leave a comment

Embedding Documentation and References

Documentation has traditionally been maintained separately from but in parallel to software systems as they’ve been implemented and maintained. Keeping the documentation in sync with an evolving system is a well-known challenge. Documentation itself comes in many forms and even … Continue reading

Posted in Software | Tagged , , | Leave a comment