# Productivity Tools

# Asana - Fundamentals

## Asana Documentation

### Getting Started With Asana

<p class="callout success">We highly encourage you to go through the [Basic Course Series](https://academy.asana.com/path/learn-the-basics-course-series) (1 hour commitment) in order to get a guided tour of the main features of Asana.</p>

### Asana Guide

The [Asana Guide](https://asana.com/guide/help) is very well written and comprehensive. This is the #1 resource you should use to explore functionalities further.

### How To Asana

Many resources are also available on Youtube. We recommend looking at the [How To Asana](https://www.youtube.com/playlist?list=PLJFG93oi0wJDMccrrEbbZha0v64Jo63K8) series to short and practical videos.

⚠️ Some videos can be a few years old. Although still relevant there might be other / better ways to do things in Asana (Ex: The time tracking video shows the Harvest integration. There's now a built-in time tracking feature.).

### Inline Help

You can access the documentation within Asana itself by clicking the "Help and getting started" link at the bottom left of the screen.

<div drawio-diagram="51"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/pp2D95Q6HoZl4qJX-drawing-3-1681844665.png" alt=""/></div>

## Golden Rule

If you need to remember one thing, remember this:

<p class="callout success">A task is only considered actionable if it is **assigned to someone** and **has a due date**.</p>

## Important Concepts

### Asana Organization

All users that have an @akvo.org email address are part of the Akvo Asana Organization.

### Asana Teams

An Asana Team is a set of people that share projects. Think of Asana Teams as a way to group projects that are related to each other. Ex:

- Internal Asana Project for an internal team
- Asana Projects used to implement a client project / contract

Teams have different [permission settings](https://asana.com/guide/help/permissions/team-permissions) that control how people can find and join teams (projects have their own permissions).

<table border="1" id="bkmrk-privacy-setting-acce" style="border-collapse: collapse; width: 100%; height: 119.188px;"><colgroup><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col><col style="width: 33.3333%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Privacy Setting</td><td style="height: 29.7969px;">Accessible by</td><td style="height: 29.7969px;">Can request to join</td></tr></thead><tbody><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Membership by Request</td><td style="height: 29.7969px;">Team members</td><td style="height: 29.7969px;">Yes</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Private</td><td style="height: 29.7969px;">Team members</td><td style="height: 29.7969px;">No</td></tr><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Public to organization</td><td style="height: 29.7969px;">Team and organization members</td><td style="height: 29.7969px;">Yes</td></tr></tbody></table>

At Akvo, Asana Teams should have the permission "Public to organization" by default.

### Asana Projects

An Asana Project is where you organize the tasks.

Make sure to share your project with the right people by clicking on the Share button (top-right corner). By default projects are shared with members of the Asana Team. You can change that as needed (similar to Google Drive documents).

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-04/scaled-1680-/GUCqwmsVczijyMOq-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-04/GUCqwmsVczijyMOq-image.png)

## Useful Features

<table border="1" id="bkmrk-feature-description-" style="border-collapse: collapse; width: 100%; height: 1461.7px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Feature</td><td style="height: 29.7969px;">Description</td></tr></thead><tbody><tr style="height: 114.125px;"><td style="height: 114.125px;">Invite Clients To Asana</td><td style="height: 114.125px;">You invite clients to Asana. This is a great way to create transparency and to have them engage with the project. Client usually have access to the Timeline and Feedback projects. You can add share other Asana Projects with them depending on their role and level of engagement.

💡 As long as their email address is not @akvo.org their account does not count towards our Asana seat count.

</td></tr><tr style="height: 96.9844px;"><td style="height: 96.9844px;">Tasks can be in multiple projects</td><td style="height: 96.9844px;">You can add tasks to multiple projects at the same time. This is very useful to avoid duplication. Ex: A task is added to te Feadback project by the client. You add that task to the Sprint Project as well so that the work of the team is is a central location. </td></tr><tr style="height: 66.3906px;"><td style="height: 66.3906px;">[Repeat / Recurring Tasks](https://asana.com/guide/help/tasks/fields#sts=Recurring%20or%20repeating%20tasks)</td><td style="height: 66.3906px;">Repeat tasks get created again when they are completed. This is useful to remind you to do something at periodically. Ex: submit your expenses every month.</td></tr><tr style="height: 66.3906px;"><td style="height: 66.3906px;">[Timeline View &amp; Dependencies](https://asana.com/guide/help/premium/timeline)</td><td style="height: 66.3906px;"> The timeline view allows you to create Gantt charts. Timelines are a very convenient way to share project update with clients.</td></tr><tr style="height: 49.5938px;"><td style="height: 49.5938px;">[My Tasks](https://asana.com/guide/help/fundamentals/my-tasks)

</td><td style="height: 49.5938px;">Everything that is assigned to you ordered in many different possible ways.</td></tr><tr style="height: 83.1875px;"><td style="height: 83.1875px;">[Inbox](https://asana.com/guide/help/fundamentals/inbox)

</td><td style="height: 83.1875px;">Inbox is your notification center for Asana. Your inbox displays updates on projects you're a member of, and tasks that you collaborate on or that are assigned to you. It's a great way to stay on top of what has happened.</td></tr><tr style="height: 49.5938px;"><td style="height: 49.5938px;">[Project Templates](https://asana.com/guide/help/projects/project-templates-2.0) / [Task Templates](https://asana.com/guide/help/tasks/templates)

</td><td style="height: 49.5938px;">You can create templates for Projects and Tasks. Great for standardizing your workflows.</td></tr><tr style="height: 83.1875px;"><td style="height: 83.1875px;">[Custom Fields](https://asana.com/guide/help/premium/custom-fields)

</td><td style="height: 83.1875px;">Useful to customize your Asana workflow and to add sort / filtering capabilities. Make sure to check whether the custom field you want to add already exists in the Akvo's field library.</td></tr><tr style="height: 133.578px;"><td style="height: 133.578px;">[Rules ](https://asana.com/guide/help/premium/rules)&amp; [Workflow Builder](https://asana.com/guide/help/premium/workflow-builder)

</td><td style="height: 133.578px;">Rules allow you to streamline routine tasks and establish workflows with ease. For a rule to work, you need a trigger that activates the rule and an action that is performed automatically. For example, a rule can be created to automatically assign a task (action) when a due date is set (trigger). Workflows provide a nicer user interface to create and manage rules.</td></tr><tr style="height: 83.1875px;"><td style="height: 83.1875px;">[Forms](https://asana.com/guide/help/premium/forms)

</td><td style="height: 83.1875px;">You can create forms to standardize the way tasks are created in an Asana Project. Forms have an external link that can be shared with anyone, even without an Asana account. Ex: Create a form to collect bug reports.</td></tr><tr style="height: 66.3906px;"><td style="height: 66.3906px;">[Proofing](https://asana.com/guide/help/premium/proofing)

</td><td style="height: 66.3906px;">Proofing lets stakeholders leave specific, actionable feedback on images so your team knows what needs to be done to complete their work.</td></tr><tr style="height: 154px;"><td style="height: 154px;">[Approvals](https://asana.com/guide/help/premium/approvals)

</td><td style="height: 154px;">Approval tasks are tasks for which the "Completed" boolean attribute is replaced by:

- Approved
- Changes Requested
- Rejected

Useful when you need more than just a simple Yes or No.

</td></tr><tr style="height: 305.125px;"><td style="height: 305.125px;">[App Integrations](https://asana.com/apps)

</td><td style="height: 305.125px;">Asana can be integrated with many other 3rd party tools. Here are some useful examples:

- [Github](https://asana.com/apps/github)
- [Figma](https://asana.com/apps/figma)
- [InVision](https://asana.com/apps/invision)
- [Slack](https://asana.com/apps/slack)
- [Google Drive](https://asana.com/apps/google-drive)
- [TestLodge](https://asana.com/apps/testlodge)
- [PowerBI](https://asana.com/apps/powerbi)
- [Zoom](https://asana.com/apps/zoom)
- [Miro](https://asana.com/apps/miro)
- [FreshDesk](https://asana.com/apps/freshdesk-asana)

</td></tr><tr style="height: 80.1719px;"><td style="height: 80.1719px;">[API](https://developers.asana.com/docs)

</td><td style="height: 80.1719px;">For anything else that is not possible with an existing App Integration, you can still rely on Asana's API. Great combo with automation tools such as [n8n](https://n8n.io).

</td></tr></tbody></table>

# Figma - Fundamentals

Figma is the cloud-based design and prototyping tool used by Akvo for creating user interfaces, web designs, and more. Its file structure and navigation is designed to make collaboration and organization easier. Here's an overview of the Figma file structure and how to navigate it:

## Workspace

Figma's workspace is where all your design files and projects are organized. When you log in, you'll see a list of your recent files and any projects you've been invited to.

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/7WiXEeqfgO4wj7p4-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/7WiXEeqfgO4wj7p4-image.png)

### Files

In Figma, files are where you create and store your design work. You can think of them as documents, similar to how you'd use files in a traditional graphic design or illustration software. Each Figma file can contain one or more pages, frames, or artboards.

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/1kp2uVxurIrC7lUt-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/1kp2uVxurIrC7lUt-image.png)

## Pages

Pages are like tabs or sections within a Figma file. They allow you to organize your content. For example, you might have one page for the homepage design and another page for the contact page. To add a new page, click the "+" button next to the existing pages at the top of the Figma canvas.

## [![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/aXLZutQkepNPJt82-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/aXLZutQkepNPJt82-image.png)  
Frames and Artboards

Frames are the containers for your design content. You create and arrange your designs within frames. Artboards are a specific type of frame used for creating different screen sizes or device views. You can add frames by selecting the "Frame" tool from the toolbar on the top left.

## [![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/R32byYXU1oURmYa7-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/R32byYXU1oURmYa7-image.png)  
Layers

The Layers panel is on the left side of the interface and displays a hierarchical view of all the objects in your design, similar to a traditional layers panel in graphic design software. It's where you can select and organize your design elements. You can also group, rename, and rearrange layers.

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/22LPDvW2Aa83kXkf-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/22LPDvW2Aa83kXkf-image.png)

## Toolbar

The toolbar is located on the left side of the interface. It contains various tools for creating and editing your designs, such as the Selection tool, Rectangle tool, Text tool, and more.

## [![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/aKzh9U0iLllcfkoF-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/aKzh9U0iLllcfkoF-image.png)Canvas

The central area of the Figma interface is the canvas. This is where you create and manipulate your design elements. You can zoom in and out, pan around, and interact with your design using the canvas.

## [![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/9scfFDtOqR0Z0JTY-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/9scfFDtOqR0Z0JTY-image.png)Prototyping

Figma also allows you to create interactive prototypes. You can define interactions, transitions, and hotspots by switching to the Prototype mode using the "Prototype" tab at the top of the screen. This is where you can create user flows and interactions.

## [![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/jmArpkLCB9uKG2ZV-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/jmArpkLCB9uKG2ZV-image.png)Assets

Figma makes it easy to manage design assets like colors, text styles, and components. These assets are usually stored in the right panel, where you can create and update design systems for consistency across your files.

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/nto2kXn8TVQW27ee-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/nto2kXn8TVQW27ee-image.png)

## Comments and Collaboration

Figma also has built-in collaboration features. You can leave comments, share your design files with others, and work on the same file simultaneously in real-time.

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/scaled-1680-/UUpAzfOd5YdYKTuj-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-10/UUpAzfOd5YdYKTuj-image.png)

# BookStack - Fundamentals

## Content Nesting

BookStack offers 4 levels of content nesting:

- **Shelves** - The top level 
    - **Books** - Used for top level content grouping. Book can belong to several Shelves 
        - **Chapters** - Used to organize low level content elements. 
            - **Pages** - Used to organize low level content elements. Note that pages can also be directly below a book.

## Useful Features

BookStack offers a lot of useful features that will help you create beautiful documents in a very efficient way. Here's a list of the most useful features.

<table border="1" id="bkmrk-feature-description-" style="border-collapse: collapse; width: 100%; height: 2164.64px;"><colgroup><col style="width: 50%;"></col><col style="width: 50%;"></col></colgroup><thead><tr style="height: 29.7969px;"><td style="height: 29.7969px;">Feature</td><td style="height: 29.7969px;">Description</td></tr></thead><tbody><tr style="height: 130.969px;"><td style="height: 130.969px;">Keyboard Shortcuts</td><td style="height: 130.969px;">Most formatting options have a keyboard shortcut that allows you write most pages directly from your keyboard.

<div drawio-diagram="29"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/ulMiW9mJYr2wPXL6-drawing-3-1680634557.png" alt=""/></div>

</td></tr><tr style="height: 190.75px;"><td style="height: 190.75px;">Code Blocks with Syntax Highlighting</td><td style="height: 190.75px;"> Many languages are supported.

<div drawio-diagram="25"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/0gvEXTsbTnm96YaE-drawing-3-1680632443.png" alt=""/></div>

**Example**

```fortran
program hello
  write(*,*) 'Hello, Akvo!'
end program hello
```

</td></tr><tr style="height: 451.734px;"><td style="height: 451.734px;">Diagrams, Drawings &amp; Math Formulas</td><td style="height: 451.734px;">You can create and insert diagrams, drawings and even [math formulas](https://www.diagrams.net/doc/faq/math-typesetting) (LaTeX) using the [Diagrams.net](https://diagrams.net) application. There's even support for [Mermaid](https://www.diagrams.net/blog/mermaid-diagrams).

<div drawio-diagram="26"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/zkA20rB42xBiOmOh-drawing-3-1680632521.png" alt=""/></div>

**Examples**

<div drawio-diagram="43"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/L0XLFUS8Wx9hmN9b-drawing-3-1680769796.png" alt=""/></div>

<div drawio-diagram="32"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/JTsilRDqofxshb2W-drawing-3-1680636049.png" alt=""/></div>

</td></tr><tr style="height: 517.938px;"><td style="height: 517.938px;">Collapsible Blocks</td><td style="height: 517.938px;">Collapsible block are useful display content on demand, in particular for long pages.

<div drawio-diagram="27"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/8idqFXCvWmrbHkCz-drawing-3-1680632806.png" alt=""/></div>

**Example**

<details><summary>I Dare You To Open 👺</summary>

[![image.png](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-04/scaled-1680-/23XNClCGTUorKCuL-image.png)](https://wiki.cloud.akvo.org/uploads/images/gallery/2023-04/23XNClCGTUorKCuL-image.png)

</details></td></tr><tr style="height: 484.969px;"><td style="height: 484.969px;">Table Formatting</td><td style="height: 484.969px;">You can pimp your tables with header and footer rows. See this table as an example.

<div drawio-diagram="37"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/4w9kOymkHmGRNcNU-drawing-3-1680636569.png" alt=""/></div>

</td></tr><tr><td>Ordering Content</td><td>You can change the display order to pages and chapters using the "Sort" menu option on the right pane of a book. See [official documentation](https://www.bookstackapp.com/docs/user/organising-content/#sorting-books).

</td></tr><tr style="height: 130.969px;"><td style="height: 130.969px;">Full Screen Mode</td><td style="height: 130.969px;">For distraction free writing you can toggle the fullscreen mode.

<div drawio-diagram="30"><img src="https://wiki.cloud.akvo.org/uploads/images/drawio/2023-04/h4p1QkUEmUYAuvfH-drawing-3-1680634615.png" alt=""/></div>

</td></tr><tr style="height: 102.562px;"><td style="height: 102.562px;">Templates</td><td style="height: 102.562px;">You can mark a page as a template so that its content can easily be reused when editing and creating pages. This can be super useful when you need to create many pages following a similar format. See [official documentation](https://www.bookstackapp.com/docs/user/page-templates/).

</td></tr><tr style="height: 124.953px;"><td style="height: 124.953px;">Webhooks</td><td style="height: 124.953px;">You can configure webhooks from BookStack in order to perform POST requests to other services (like [n8n](https://n8n.io)). Many (if not all) application events can trigger a webhook.

**API Documentation:** [https://wiki.cloud.akvo.org/api/docs](https://wiki.cloud.akvo.org/api/docs)

</td></tr></tbody></table>