While discussing the documentation, issues were raised about the diagrams in the documentation.

1) It was felt that some of the diagrams looked a bit old fashioned

2) The sources for images seemed to be lost or held outside the SCM.

This encouraged me to look at ways to improve the production of images for the documentation.

I had the following as goals:

a) The tools used should be open source so everyone can use the same sources.

b) The tools should not require specialized expertise to use.

c) It must be possible to produce images that can be used in other tools (Confluence Wiki includes drawing tools but there is no way to use the images outside confluence).

d) There should be a library of relevant images.

At the meeting Visio and Apache OpenOffice Draw were mentioned as possible drawing tools. Visio is an excellent product but is proprietary.

Apache OpenOffice Draw is an Apache product and very well supported.

After a bit of research I found a library of OpenOffice symbols from VRT (http://www.vrt.com.au/downloads/vrt-network-equipment) that seems to include many of the symbols that we need.

I tested the addition of the library into OpenOffice using the normal add-on process and it works well.

Requires a restart of Open Office after the update but that is to be expected.

I used it to create an equivalent diagram for one of the drawings from the current doc set.

You can see the results and a short discussion at http://blog.artifact-software.com/tech/?p=305

The OpenOffice Draw source can be downloaded from the article to see how the png files where created.

It is possible to produce many output formats beside png from OpenOffice.


Ron


--
Ron Wheeler
President
Artifact Software Inc
email: rwhee...@artifact-software.com
skype: ronaldmwheeler
phone: 866-970-2435, ext 102

Reply via email to