Reference Implementation

So far, we have been describing just the first pillar of the Effective Analysis – the theoretical principles and techniques. We presented what practices we think should be applied and what should be avoided in order to switch analysis and documentation efforts to the faster lane. Although most advice was complemented with real-world examples, they were still just a theory.

All theory, dear friend, is grey, but the golden tree of life springs ever green.

– Johann Wolfgang von Goethe

In this part, we will take the principles introduced in part II and demonstrate how to implement them using the concrete CASE tool and wiki software.
Nevertheless, as previously mentioned, the CASE and wiki are not enough. To be able to take the best from both worlds, it is necessary to synchronize the information between the tools which requires deploying a "middleware" to automate it. On that account, the essential part of the Effective Analysis is also our custom developed solution, which is presented in this part as well.

So we have the principles and the solution. Although this combination itself would increase the effectiveness of the analysis and documentation efforts, we decided to go even one step further. Apart from presenting the principles and tools, we would like to also demonstrate how to apply them in the real world. This is why we were still not satisfied and added also supporting materials, such as artifact templates and repository structure examples, to provide teams with a ready-to-use framework. We believe that with such an all-in-one package, teams can start implementing the basics very quickly and then tailor the approach according to their specific requirements and needs.