Cards are the building blocks of a project. If you are working on a particular task, there should be a card documenting it in the project.

Types of cards

There are two types of card.

Simple cards

Using the "+" sign on the right sign of a project column you can add a simple plain text card.

Actions and formatting on a simple card is quite limited and might be suitable only to quickly record some quick thought. It's best to eventually turn them into "issues".

Issue cards

Issues are an independent concept associated with a repository and typically represent tasks, bug report and feature requests for that repo.

You can create a card from an existing issue by using the "Add card" button in the top right of the screen.

It will provide a list of existing issues you can drag and drop on the board.

Note that some simple automation is in place and new issues are automatically added to the "To do" column in the project.

Issue cards are quite more powerful than simple cards. Some of the advantages:

• Allow comments/conversation, allow keeping track of updates/progress;
• You can assign people/teams to an issue (card);
• You can label issues.

Additional info about cards/projects interaction can be found in the official documentation.

Tasks and issues: two peas in a pod

In our scenario "issues" is an unfortunate name and let's just hope there won't be any real issue with the project. A better word for it is task.

Regardless of how we decide to call them, we should try to keep a 1:1 correspondence between cards and issues. In the long run issues will serve as documentation for other and your future self.

Gateway cards/issues

Sometimes I find it useful to gather smaller tasks under the same roof (please, keep in mind the rule of 6 still applies). This "macro-issue" gives an overview of the tasks, explains why they are somehow related and links to them.

If you think you might find it useful, feel free to use this technique.

Note that gateway issues don't need to appear in the project board (the subtasks will be already there, anyway).

Templates

You feel intimidated by the task of creating a new issue? Use one of the custom templates during the process of creation of the issue. It might ease the pain a bit.