Review


Nowadays I have no time to share my thought here, furthermore I have a tough NDA been signed, so nothing to be mentioned about recent events.

But, I have found a good article describing how a senior code developer evolves. Enjoy!

http://mattbriggs.net/blog/2015/06/01/the-role-of-a-senior-developer/

And another new expression: code origami. I like it.

Advertisements
Previously: EPF Composer

BPMN – Bizagi Process Modeler

I had to continue seeking ways to show processes visually. I knew UML2 together with its limitation, and I looked for other standard modeling languages to visualize process flows. I found BPMN, Business Process Modeling Notations. First I read the standard, and I found that very useful. I found BPMN support in Visio, but it was really cumbersome to draw process models. I gave up. Then I started to browse the internet systematically to find support tools for BPMN. Sourceforge did not provide solution, but I found Bizagi Process Modeler. This application is a (free) part of a huge system, what is able to compile and execute the models you create in BPMN. It looked very impressive. Of course I downloaded it immediately and started to use. It was awesome! It knew everything I missed before with other tools! It fully supports BPMN, but lets you to deviate a bit from the standard. Drawing is easy and fast. I really recommend.

So, I found the best tool ever to visualize our processes. The question was how I can integrate the pictures with the text, and how the user can browse it easily. I used one of the oldest solution: HTML. I put HTML imagemaps on the pictures I exported from Bizagi Process Modeler and linked them to the appropriate parts of the text. It works well, easy to browse, easy to maintain. I’m satisfied so far, but I’m sure I’ll try other tools if I find any. I’ll let you know if I see anything better than Bizagi Process Modeler.

Previously: Enterprise Architect and StarUML

EPF Composer

We were coding our products in Java Eclipse, and when we looked for add-ins to Eclipse we accidentally bumped into EPF Composer. This is an XML based tool for Eclipse that is able to handle all types of objects necessary to describe processes. First I did not want to get rid of UML, but I had to change my mind. EPF Composer is able to contain both text and process flow diagrams, and maintain the links between the objects. I really loved working in EPF Composer! It had a template for processes, containing fields for all interesting aspects, like summary, description, roles, WBS, and even best practices, templates and guidelines. It’s a really powerful tool! Generally I was really satisfied with EPF Composer and its features. The designed process definitions appeared in an HTML based report what we were able to share on our HTTP server. But, of course there were issues. It works well only if you use the same structure that has been defined in the software. This structure is too complex, because it needs to be able to store everything. We wanted to simplify that, but when you skip an object between two others (like process – roles – role definition path you want to get rid of role level, as role definition is enough) you cannot hide the intermediate object, therefore users need to click twice to find the appropriate object. In other words: you have to use and maintain all objects, which were defined in the application. We gave up using EPF Composer.

Will be continued…

Previously: Visio

UML – Enterprise Architect

We used Enterprise Architect to maintain our software designs, so it was straightforward to try its Business Process extension to draw our processes. Enterprise Architect did the work, it was quite easy to show who does what. It provided solution to keep our document templates just next to their definition, and it was able to track the changes made during continuous improvement. There was only two drawbacks: its price and the lack of acceptable and readable export.

UML – StarUML

UML had led us to success in Enterprise Architect, so we looked for another tool supports UML2, for free. I found StarUML, which is a quite good UML modeling tool, and it is open source. I started to redraw our process models in it based on the Enterprise Architect models. I could draw only the first few boxes to realize that StarUML supports connections only according to the UML standard, while EA was more flexible. It was impossible to create drawings with the same information content.

Will be continued…

Previously: RoboHelp

Visio

The first tool I wanted to use to create graphical overview of the Quality System was Microsoft Visio. It is able to draw anything you want, but sometimes the standard license is not enough. Professional one costs a fortune. I entered an overview of the system, and then one of the most complicated processes: Software Development Life Cycles. The initial drawing was not an issue, but later maintenance was a pain. Visio handles the graphical elements as graphical elements – how surprising -, and all of them has its own isolated life. Arrows crosses boxes, overlaps, and it is cumbersome to align boxes. Since process development normally means hundreds of changes in the first period, I gave up after a few days. I really do hate Visio.

Will be continued…

 

Previously: PDF

Robohelp

When we failed with PDF files, we initiated a project to look for possible tools to migrate the Quality System in. Since the main lack was the integration of the different processes, tools were sought that support one click reference between document parts. HTML seemed to be the most appropriate solution. The documentation team began seeking a tool, which is able to generate HTML or any other browser supported content. They evaluated Frame Maker and RoboHelp among some other free tools. RoboHelp has been selected with Flash content generation.

The documentation team migrated the entire quality system to RoboHelp. It took a week only, and then we started to revise and close the gaps between the independent processes. In half year the quality system was better than ever before. Some people, who were a bit more familiar with the content started to read and refer to clauses in the Quality System. In the years before there was only a few change requests, after the migration almost a hundred arrived in 5 months. The Quality System has got alive.

There was still an issue: newcomers were not really able to find the things in the QS. There were no pictures in that, only text, text and text. And as we used the documents, we realized that there are still gaps and mismatch between processes, and the description of some processes was still confusing. I decided to look for ways to show the system graphically.

Will be continued…

 

Before: Paper based

PDF

When I joined, they had the quality manual in electronic form: PDF files. It was more suitable to handle. Furthermore they did not distribute the manual to every employee at every change: the latest version was only available on the intranet, and it was forbidden to create hardcopies.

Worked, but still, there were problems. Every process was in separate PDF file and the links between them was not successfully maintained. The consistency has gone as changes were made. To avoid of frequent changes the processes were designed on too high level, only providing requirements to the daily work, not best practices or a real workflow with advices. Therefore staff did not feel that is helpful enough; they were not able to overview that. They were not allowed to copy and store the documents, so they needed to download them every time. This would have been fine, if the server had not been 2000 km away, behind an internet access with extreme narrow bandwidth…

This was an acceptable way to handle these documents, until the company was taken over by another one. The acquisition required the complete revision of the quality system, and that required a lot of changes. These changes made PDF files confused, full of interfering processes, undefined roles and inconsistent terminology. A change was necessary.

Will be continued…

Next Page »