Managing TODOs
Overview
An initial list of Backlog TODOs is created when a Baseline Measurement of an Application is created. A list of Drift TODOs is created when a next Measurement is created as a comparison with the Baseline Measurement.
The list of TODOs is updated after a round of automatic Learning and Analysis is completed. The most updated Measurement will be automatically tagged as the Latest Measurement.
How to Access the TODOs List for an Application
To access the TODOs list:
- Log into the vFunction Server UI
- Select the Analysis tab in the top, center menu bar
- Select the Bulleted List Icon in the top, right corner. Note that a Baseline Measurement must be set to see TODOs.
Set a Baseline Measurement through the following steps:
- Log into the vFunction Server UI
- Select the Analysis tab in the top, center menu bar
- Hover over Measurements in the top, left corner
- Select Set As Baseline from the submenu options
- Select Expand TODO to see a full-page list of the TODOs
Types of TODOs
There are three types of TODO items:
- Backlog: a TODO that was auto-created when the Baseline Measurement was set. These types of TODOs provide a list of steps that could be taken to improve the Application’s Architecture based on Architectural Best Practices
- Drift: a TODO that was auto-created due to an event created after learning and analysis, for example, a new domain was added or a domain exclusivity had changed
- Manual: a TODO created by the user during analysis, for example, to remove a reference to a dead code class or to make a class exclusive by refactoring it’s code
Status of TODOs
The status of TODO items is updated following an automatic Learning and Analysis. The Status of a TODO item can be:
- TODO (orange): the item has not been addressed
- DONE (green): the item was resolved / addressed
As seen in the figure above, the TODO list can be filtered by the event that caused the creation of the items, the type of TODO or the current status.
The user can click on a TODO item with Status: TODO and then perform actions:
- Snooze defers handling the TODO
- Dismiss ignores the TODO item
- Locate will route the user to the relevant element in the Analysis in a new browser tab
- Open Ticket will open a dialog box to create a new Jira or Azure DevOps ticket if the vFunction Server has been configured for an Issue Tracking integration
The user can click on a TODO item with Status: DONE and can either:
- Acknowledge removes from the TODO list
- Locate will reoute the user to the relevant element in the Analysis in a new browser tab
Clicking Expand TODO will open the TODOs dashboard showing a more detailed table of the TODO items as well as TODOs for the other applications, which is useful to oversee the entire application porfolio by Enterprise Architects.