views:

620

answers:

7

I like a wiki to contain information that needs to be known within a team. Having the expression in mind, "A picture is worth a thousand words", I would like to make a small class diagram, sequence diagram or component diagram inside a wiki using an ajax or flash plugin.

We currently don't do any technical design because they are often lost in some program or out dated. Being able to put these in a wiki (and update them there) would make them useful again.

Do you know of any wiki's that have that functionality?

+3  A: 

ikiwiki supports a graphviz plugin. It's neither ajax nor flash, but graphviz input files are plain text which makes them easy for anybody to edit.

Greg Hewgill
+2  A: 

We use Confluence from Atlassian (see www.atlassian.com). In there is a component called Gliffy for making diagrams. It works great. It's not free software.

Frans
A pity that it is not free. Seems really nice and would be better than the solution I accepted.
JeroenWyseur
+1  A: 

try using this http://websequencediagrams.com/ and copy the url into the wiki - works for all wikis that support img linking.

Chii
+12  A: 

websequencediagrams.com also works with Confluence and Trac as well as output to images. If your wiki lets you insert raw html, you can include the diagram right in the page. That way, the diagram automatically updates.

<div class=wsd wsd_style="modern-blue" ><pre>

Alice->Bob: Programming Question
Bob->StackOverflow: (forward request)
StackOverflow-->Bob:
Bob-->Alice: answer
note right of Bob: he he he!

</pre></div><script type="text/javascript" src="http://www.websequencediagrams.com/service.js">&lt;/script>

Result:

Steve Hanov
Yes, having found this I'm now using it. It's a shame we can't go from the weird URL to the original text - I had to modify redmine to allow entering of raw HTML to get this to work.
Jim T
Now the site gives you an option to "Link to this page" so you can get back the original text from the weird url.
Steve Hanov
Awesome tool! Thanks a lot for sharing.
Niklas
+4  A: 

TWiki with the TWikiDrawPlugin

Sam Hasler
A: 

With MediaWiki you can use this Extension:

UML Extension

zioalex
A: 

For defining dependency/layering rules visually you could try structure101. Has the advantage that the diagrams are not just graphics - plug it into your build and it will check the code against the diagram and flag violations. There's also an IDE plugin that will warn developers if code changes break the architecture. It works off a light web application so I guess you could just link to it from your wiki. The web app and IDE plugins are free but you need at least one client license to create and maintain your architecture diagrams.

A cell should only depend on cells lower in the diagram, else they are flagged as a violation:

alt text

Chris Chedgey