Workspace - techtalk/SpecLog-Resources GitHub Wiki

Workspaces are used to map requirements in a SpecLog repository visually, e.g. to create a story map, impact map or feature tree.

Story map on a workspace:

Zoomed out workspace displaying a feature tree:

Navigating on workspaces

Workspaces are of infinite size. To navigate within a workspace:

  • Click on a free part of the workspace and drag your mouse while holding down the mouse button.
  • Use your mouse wheel to zoom the view. Depending on your zoom level different content is displayed in the requirement cards.
  • Use the Navigator Tool Widget to navigate and zoom.

Managing workspaces

All workspaces are listed in the Workspaces widget. You can add, open, rename and delete workspaces here.

Viewing multiple workspaces

Workspaces are opened in tabs. You can open multiple workspaces in multiple tabs. Opening or closing a workspace's tab does not affect the workspace and any changes to workspaces are immediately saved automatically.

Requirements are displayed as cards on a workspace. To add cards to a workspace, either drag an existing requirement from the Requirements wisget, or add a new requirement using the New Requirement widget.

Mapping requirements on a workspace (story maps, impact maps)

To create a story map or impact map, you need to add a workspace and map your requirements onto the workspace.

The number of requirements on a workspace and the sum total of their estimates is displayed at the top of the workspace. If you select requirements, the summary at the top also indicates how many requirements have been selected and what the total effort entered for those requirements is.

Select requirements by Ctrl-clicking them, or drag a selection box around the desired requirements while holding the Ctrl key.

Managing large maps

If your map becomes too large and you can no longer view the necessary details at a comfortable zoom level, you can split it into multiple maps, with a higher level global map and multiple maps going into more detail.

The same requirement can be present on multiple workspaces, e.g. on your high level global map and on a more detailed workspace. The workspaces that a requirement is present on is displayed in the requirement details:

Click on a workspace's name here to switch directly to that workspace.

The following feature map contains the entries in the feature tree relating to synchronisation:

Moving and Copying Requirements Between Workspaces

You can move and copy requirements from one workspace to another. To do so:

  1. Open both the source and target workspaces so that they are displayed as a tab at the top of the screen.
  2. Select the requirement(s) you want to move or copy on the source workspace. Hold down Ctrl and drag the selection rectangle to select multiple requirements.
  3. Drag the requirement(s) to the target workspace's tab at the top of the screen.
  • Simply release the mouse button when over the target tab to move the requirement(s) to the target workspace. The requirements are removed from the source workspace and added to the new workspace.
  • Hold down Ctrl while releasing the mouse button to copy the requirement(s) to the target workspace. The requirements are not removed from the source workspace and are added to the new workspace.
    Note: When copying requirement, the same requirement is shared between the workspaces; editing the requirement on one workspace means your changes are applied to all instances of the requirement on all workspaces.
⚠️ **GitHub.com Fallback** ⚠️