An iRise project is only as good as the feedback and collaboration it generates. While building great simulations is one key step in making this happen, there are a number of additional steps you can take that will ensure a great reviewing experience for your stakeholders. And in the world of software visualization, engaged stakeholders lead to productive review cycles.
Watch this video for a demonstration of the topics covered in this tutorial.
Project reviews can take place under a wide variety of circumstances. One organization's idea of a productive environment for collaboration might look completely different from that of another organization, and environmental constraints might make it impossible for either organization to collaborate in their ideal setting.
Selecting the right mix of reviewing features in your iRise projects, and deciding how much scaffolding to provide to your reviewers, is a process that needs to happen separately for each of your projects. While some organizational standards might be implemented (e.g., start page templates), certain factors such as geographic dispersion of project teams and intended uses of your simulation still need to be considered.
This analysis of the project environment will often dictate the manner in which you use the tools discussed below. To the extent possible, we'll provide some tips to help guide not just the mechanical aspects of their use, but also your selection of the right tools for the job.
The start page is the first page that your reviewers see when they launch your simulation from a Definition Center or an iDoc. You can use this feature to your advantage by creating a start page that provides key information that will enhance the reviewer's experience and improve your chances of getting the feedback you need. Your start page can also serve as a "splash page" for your simulation, providing an attractive, inviting introduction to your project.
Setting your project's start page is easy:
A small greenÂ dot will appear to the left of the chapter's name in the Directory. Remember that your selection only affects the simulation when launched from a Definition Center or an iDoc. Launching your simulation from within Studio will still open whichever chapter is currently displayed in your workspace.
As you design your start page, keep the following recommendations in mind:
The SimWealth, SimBank and SimRetail iDocs in the Simulation Resources area of iRise.com each provide a good example of a start page that you can use as inspiration or a template for your own start page.
When you can personally lead a review session, everyone benefits from your ability to navigate through the scenario exactly as you intended. You can show what needs to be shown, and get exactly the feedback you need.
When your simulation will be reviewed remotely, however, you have little control over the path your reviewer takes through a scenario. That is, you have little control unless you make use of Guides.
Guides are annotations that you can add to your pages in iRise Studio. They can be toggled on or off in iRise Reader so they appear only when they are needed, and can be used to provide any type of information to supplement the simulation itself. Common uses for Guides are to provide walkthrough notes to reviewers, specific instructions for interacting with the simulation, or background information pertinent to the page being reviewed.
Guides can be configured to display whenever a page loads in the Reader, or they can be associated with specific content on the page so they are revealed when the reviewer mousesÂ over the content. They can also be configured so they display only when the page is viewed in the context of a particular scenario so you can provide information relevant to that scenario.
Adding a Guide to a page is as simple as dragging the Guide icon from the Widget Toolbar to the page's canvas, and then typing the Guide content in the Properties panel (shown above). To associate the Guide with a specific widget on the page, just drag the Guide icon from the canvas and release it on the widget. The association will be indicated in Studio by a pale yellow line connecting the Guide icon with the page widget.
You can display the contents of your Guide in Studio by double-clicking the Guide icon on the canvas.
Whether you conduct stakeholder review sessions in a live meeting or asynchronously, the integrated commenting features in iRise are a powerful tool for recording and managing the feedback you receive from project stakeholders. Comments added to a project either in Studio or iRise Reader are automatically associated with the page or scenario to which they were added, and can even be associated with specific content, ensuring that feedback is on-target and never taken out of context. Comments from multiple reviewers are seamlessly aggregated within your project, and if your project is on a Definition Center, those comments are viewable in Studio in real time.
Adding a comment to a project is extremely simple, and differs only slightly between Studio and the Reader:
Comments that are added to a simulation that was launched from Studio or a Definition Center automatically become part of that project, and can be viewed by anyone with access to the project both in Studio and on the Definition Center. Comments added to a simulation that was launched from an iDoc must be imported into the project in Studio after the reviewer sends the iDoc back to the modeler (File > Import > Comments).
Once the comments are embedded within the project, they become a key part of your modeling workflow, with each of the following features and capabilities adding to their usefulness: