The Boring Task
Overview
The Boring Tasks keeps your developer to-dos inside Mendix Studio Pro.
Write a line like TODO: check the login flow in an annotation or in a document's documentation, and it shows up in the Tasks pane. See the tasks for the document you're working on, or every task in the app grouped by module. Click a task to jump straight to it. Add, edit, delete and regroup tasks without leaving the editor.
Pick your own tags and colours, such as TODO:, BUG: or 🔥. Tags match exactly as you type them.
Your tasks are plain annotations and documentation, so they stay in your model even if you remove the extension. No accounts, no cloud, no extra tool to keep in sync. Just boring task management.
Documentation
## Introduction
The Boring Tasks is a Studio Pro extension that collects developer to-dos from your model into one pane. Tasks are lines in annotations or in a document's documentation that start with a tag, like TODO: check the login flow.
### Typical use cases
Leave notes for yourself or your team in a microflow, nanoflow or domain model, and find them all again later.
Review open work per document or across the whole app before a release.
Use your own tags, such as
BUG:orREVIEW:, to track different kinds of work.
### Features
A Tasks pane with two tabs: Current document, which follows the active editor, and All, which lists every module from A to Z.
Tasks are grouped per document into linked annotations, free annotations and documentation.
Clicking an annotation task opens the document and selects the annotation, or the element it is linked to.
Add, edit and delete tasks in microflows, nanoflows and domain models.
Drag a task onto another group header to move it.
Configurable tags, each with its own colour. Tags match exactly as typed, including punctuation and emoji.
The list refreshes automatically when the model changes.
### Limitations
Tasks in documentation are read-only in the pane. Edit them in the document's Documentation property.
Adding tasks is only possible in microflows, nanoflows and domain models.
## Installation
Download The Boring Tasks from the Marketplace into your app.
Restart Studio Pro if it asks you to.
Open the pane from Extensions > The Boring Tasks > Show tasks.
Requires Studio Pro 11.16 or later.
## Configuration
The default tag is TODO:. To change tags, click the gear in the pane header or choose Extensions > The Boring Tasks > Settings.
Add a tag, pick a colour, and click Save. The pane rescans immediately.
Tags must be unique and cannot be empty. At least one tag is required.
When one tag is part of another, the longer tag wins.
Settings are stored in the-boring-tasks.settings.json in your app folder, next to the .mpr file. Commit it if your team should share the same tags.
## Usage
Type a task in an annotation, for example
TODO: rename this entity, or in a document's Documentation property.It appears in the Tasks pane with a coloured tag badge.
Click the task to jump to it.
Use Add task to create a new annotation task in the current microflow, nanoflow or domain model.
Use the pencil to edit a task's tag and text. Enter saves and Escape cancels.
Use the trash icon to delete a task. If it is the last line, the annotation is removed.
## Your data
Tasks are ordinary annotations and documentation in your model. If you remove the extension, your tasks stay where you wrote them.
Releases
You can now edit and delete documentation tasks from the pane. Before, they were read-only.
Double-click a task to open the inline editor.
New Maia AI tools:
tools_list_tasks,tools_create_task,tools_edit_taskandtools_delete_task. The first time, Studio Pro asks you to grant the AI tools permission in the Extensions Overview. They use a beta Studio Pro API.
# The Boring Tasks 0.1.0
First release. The Boring Tasks lists the tasks you write in your Mendix model, so you can see what is left to do without leaving Studio Pro.
## What it does
Tasks pane. Open it from Extensions > The Boring Tasks > Show tasks. Current document shows the open editor's tasks and follows you as you switch editors. All lists every module from A to Z.
Tasks from annotations and documentation. Any line that starts with a tag becomes a task. Tasks are grouped per document into linked annotations, free annotations and documentation.
Jump to the task. Clicking an annotation task opens the document and selects the annotation or the element it is linked to. Clicking a documentation task opens the document.
Add, edit and delete. On microflows, nanoflows and domain models you can add a task as a new annotation, add a line to an existing one, edit its tag and text, or delete it. Enter saves and Escape cancels. Documentation tasks are read-only.
Drag to regroup. Drag a task onto another group header to move it there.
Your own tags. The gear in the pane, or Extensions > The Boring Tasks > Settings, lets you add tags with their own colour. Tags match exactly as you type them, punctuation and emoji included, and the longest matching tag wins. The default tag is
TODO:.Lives in your model. Tasks are plain annotations and documentation, so they stay in your app even if you remove the extension. Tag settings are kept in
the-boring-tasks.settings.jsonnext to your .mpr.
## Requirements
Studio Pro 11.16 or later.