Managing Guide Production Tasks with Nextcloud Deck
TDF LibreOffice Document Liberation Project Community Blogs Weblate Nextcloud Redmine Ask LibreOffice Donate
The LibreOffice Document team uses Deck, Nextcloud's kanban-style task management system, to track production of the LibreOffice User Guides and some other documentation processes.
In Deck, a board is created to track a specific project, for example the production of the LibreOffice Getting Started Guide. The board is divided into columns which represent different stages of the project, for example Pre-production, In Progress, Peer Review, Editing, and Published. Each task relating to the project is then assigned a card, which contains details about the task, including a checklist of sub-tasks. As the task moves through each stage of the production process, the card is moved to the corresponding column.
Tracking tasks
- Assign a task to yourself or have it assigned by another (see Assigning a task).
- Go to the Attachments tab to access the working file. Files are stored on Nextcloud.
- Update Tasks in the Checklist as you complete them.
- When the task is ready to move to the next stage, drag and drop it onto the next column and, if relevant, add an additional assignee, such as a peer reviewer.
Accessing Deck
The Deck app is accessed via the Document Foundation cloud. In order to access the cloud, make sure you have a LibreOffice Single Sign On (SSO) account. If you don't already have an SSO account, follow the instructions on the Single Sign On page to get one.
To access Deck:
- Go to https://nextcloud.documentfoundation.org/apps/deck, or
- Click on the Deck icon in Nextcloud.
Sharing a board
In order for a user to see a board or be assigned a task, the board must first be shared with them. To share a board:
- Click on the menu at the top, right of the board.
- Select a user's name from the Share board with a user, group, or them combo box to share the board with them. Start typing a name into the box to search for a user.
- Add additional privileges if necessary. Users are assigned editing privileges by default.
Assigning a task
To assign a task:
- Double-click on the task to open it.
- Click on the Select a user to assign to this card combo box.
- Select the assignee's name from the dropdown. If you don't see a name, start typing in the field to search for an assignee.
To quickly assign a task to yourself:
- Click on the ellipsis (... ) in the bottom right corner of the card.
- Select Assign to me from the sub-menu.
Cards
Each card contains four tabs that contain different information about a task:
Details
The details tab includes a description of the task, including a checklist of sub-tasks. Check off the sub-tasks in the list as they are completed.
Attachments
Use the Attachments tab to link and access files relevant to the task. To add an attachment:
- Open a card.
- Open the Attachments tab
- Select Share from Files.
- Use the file picker to select a file from Nextcloud.
- Click the Choose [File name] button.
Always use the Share from Files button to link files on Nextcloud. DO NOT use the Upload new files button. This helps to make sure that all files are kept in the WIP and Published directories for the relevant guide. It also prevents multiple, conflicting copies of files from being created.
Comments
The Comments tab is a useful way to record useful information about the task, leave a note for another user, or discuss the task with other users.
To add a comment to a card:
- Open a card.
- Open the Comments tab.
- Start typing in the text field below your name.
- Press the arrow icon to save the comment.
Replying to a comment
To reply to a comment:
- Click on the ellipsis (…) next to the name above the comment you want to reply to.
- Select Reply.
Activity
The Activity tab logs any changes that have been made to a card.