(and a few other free tools) to create a high-level interactive map of software projects.
: A high level map of a large software project is needed. Any number of facets including executables, plugins, file formats, databases, dependencies, and clusters of packages may be displayed.
: Using a traditional diagram editor to create such a map manually is time-consuming and tedious. Also, changes may require extensive re-layout of the map. Although GraphViz
can be easily adapted to a script, adding Wiki, HTML, or DoxyGen
greatly amplifies the system.
: Apply the following recipe:
- Create a GraphViz dot file with the required linking information, maybe with a script.
- Run GraphViz once to generate an image of the graph.
- Run GraphViz again to generate an html image-map of the graph.
- Create an index.html (or wiki page) with an IMG tag of the graph, followed by the image-map's html.
- Direct the image-map urls to a Wiki page with each node's name - generate the Wiki pages automatically if needed.
- Optionally, link directly to the class hierarchy image generated by DoxyGen.
- Have the Wiki page link to any additional documentation, including DoxyGen docs, images, etc.
- The page will display a high-level graph of "everything". The graph can be descended to project/module/etc-specific information.
- Potentially, the entire map can be visual and hot-linked to other maps, including the overview map.
- The warm feeling of peering down on complexity from your lofty perch.
- Impresses visitors and marketing types by being the neato overview that hollywood movies have - and it works.
- Acts as a knowledgebase and organizer for the system.
Comments? Anyone else done this? -- LayneThomas
Sure. This a great application of GraphViz
and related tools. In the past I have generated method calling data from Ruby code, then plotted it using GraphViz
. You might be interested in MiniRubyWiki
, which lets you imbed GraphViz
code on wiki pages. --