Items

Filters in the "Items" Section of DevStride

The Items section in DevStride is a comprehensive list view that allows you to manage a variety of work items such as tasks, bugs, stories, and more. Utilizing filters in this section can streamline the process of managing and locating specific items. This documentation will guide you on using filters in the Items section.

Accessing Filters

To use filters in the Items section:

1. Go to the Items section from the sidebar menu.
2. Click on the Filters button located in the top toolbar, next to the Sort and Options buttons.

Types of Filters Available

You can filter the items in the list by various criteria:

• Parent: Display items that are children of a parent item.
• Item Type: Filter by the type of item, such as Story, Task, Bug, etc.
• Team: Show items associated with a selected team.
• Assignee: Filter by specific team members to whom the items are assigned.
• Priority: Arrange items based on their priority level.
• Tag: View items that are marked with specific tags.
• Field: Filter by custom fields that you've set up for items.
• Cycle: Display items based on the development cycle they belong to.
• Board: Show items based on their status in a board view (e.g., To Do, In Progress).
• Status: Filter items by their current status (e.g., New, In Progress, Done).
• Start Date: View items by their start date.
• Due Date: Filter items by their due date.
• Completion Date: Show items that were completed within a date range.
• Time Spent: Display items based on logged time.

Filtering by Completion Date

The Completion Date filter narrows the list to items that finished within a specific window of time. It looks at the moment each item actually entered a completed (Done) state, so it reflects when work was truly finished rather than when it was scheduled.

To filter by completion date:

1. Click the Filters button to open the filter options.
2. Choose Completion Date.
3. In the Completion Date dialog, set the range by either:
   • Picking a from and to date, or
   • Choosing one of the relative range presets.
4. Save the range to apply the filter.

When the filter is active, it appears as a pill at the top of the list reading Completion Date: followed by the range you selected. You can clear it on its own by removing that pill, without affecting your other filters.

A few things to keep in mind:

• It's a range, not a single date. You set a from and to (or choose a relative preset) and the list shows items completed within that window. Relative presets cover periods of up to one month.
• Both ends of the range matter. The filter applies only once both the start and end of the range are set.
• Folders and workstreams have no completion date. Because these container types never enter a Done state, the Completion Date filter is based on work items rather than the folders and workstreams that hold them.

Applying Filters

To apply a filter to your items list:

1. Click on the Filters button to open the filter options.
2. Choose the filter category you wish to use.
3. Select the criteria from the options that appear.
4. The items list will update to only show those that meet your filter selections.

Any view options you turn on appear as green pills in the filter bar, so you can see at a glance what's active.

Combining Filters

To further refine the items displayed:

1. Apply an initial filter following the above steps.
2. Open the Filters menu again to select additional filters.
3. The items list will adjust to display only those that meet all of your specified filter criteria.

Clearing Filters

To clear the applied filters:

1. For individual filter removal, click the X on the filter tag at the top of the list.
2. To remove all filters at once, click the Filters button and select the Clear option from the dropdown menu.

This action will reset the items list to show all items without any filtering applied.