Requirements and Diagrams - Warfighter Made - Part 4

As we continue with the Warfighter Made requirements gathering and in addition to the mock up tool selected we needed to have a tool able to facilitate some drawing and diagramming of the platform. If you do a quick search on the Atlassian Marketplace you will find multiple options, I decided to go with Gliffy as I used them during the development of the open source environment for EHR (www.vxvista.org).

Empowering Confluence pages with diagrams

It is well known that an image has more value than thousands words and I noticed that since I started creating content in Confluence. Moreover when interaction is added into the diagrams created opening the possibility of connecting multiple pages with more details.

A simple Gliffy Diagram helped me to represent the overall architecture of the new platform that is basically based on three pillars: Help Center, Project Tracking and Collaboration environment.

Gliffy1.jpg

Gliffy diagraming tool helped us to easily show the taxonomy of the new platform to be developed for Warfighter Made. The screen capture is from an active session using Gliffy.

Gliffy2.jpg

Once finished and saved, the graphic is embed as content into the Confluence page and it looks like any other image. The file is attached to the page and it is ready for editing or to be saved as pdf with the rest of the page content.

 

Diagrams and Jira Workflows

In addition of representing the environment taxonomy we used Gliffy to show a simplified version of the Jira Workflow. The diagram helped us to explain to the Warfighter Made the workflow steps that go along with their requirements.

Gliffy3.jpg

Jira Workflow overview for Warfighter Made CEO

 

gliffy4.png

Jira Workflow with transitions

 

Overall Architecture and use of icons on Diagrams

In addition to the traditional diagrams shapes Gliffy allows the use of icons to better represent the players on the information flow.

gliffy5.png

Information flow on the whole environment. Overall architecture

 

Images, Words or both?

I personally prefer both, images and words combined and interacting together. As a matter of fact, having a high level diagrams, with hyperlinks to details pages will allow the user to dive dipper when needed and at the same time to have the big picture. Gliffy installed in Confluence added a good amount of value during the requirements gathering phase. It is a solid and reliable add on and I am glad that they are also participating on the non profit license sponsored by Atlassian. It really makes the difference with this project for Warfighter Made.

 

 

More about this project

The goal is to share on this series of blog-posts how we are building the new collaboration platform for Warfighter Made. See below the list of completed and planned blog posts.

 

 

 

 

0 comments

Comment

Log in or Sign up to comment
How to earn badges on the Atlassian Community

How to earn badges on the Atlassian Community

Badges are a great way to show off community activity, whether you’re a newbie or a Champion.

Learn more
Community showcase
Published May 16, 2018 in Teamwork

Michael Kimathi: A (soon to be) viral video + the key to unlocking personal and community growth

...me as a true entrepreneur because my journey entails building solutions and helping build solutions which impact the lives of people and communities around me. I graduated with BSc Computer Science...

331 views 7 11
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you