Skip to main content

Docs

Create clarity for your team by uniting documentation and project work in one place. For better context and most efficient teamwork. 🤝

Laura Timm avatar
Written by Laura Timm
Updated this week

Understanding the General Docs Structure

When it comes to managing your docs in our platform, it's important to understand the general structure of our Docs Feature. There are three main places where a doc can live: private docs, space docs, and project docs.

Private docs

Private docs are similar to private projects in that they can only be seen by you until you choose to share them with another user or move them to a space or project. These docs are only accessible to you and are not visible to anyone else in your workspace.

Space Docs

Spaces can be seen as folders within a workspace. These are where docs are managed and organized within a specific workspace. You can create multiple spaces within one workspace, and each doc can only exist in one space at a time. Docs can be moved from spaces to spaces or even into a project.

Project Docs

Project docs are connected to a specific project and can only be accessed through that project. These docs are always linked to the project and will remain there until they are moved to a space or made private. This ensures that all project-related docs are easily accessible and organized within the project. Project docs have special features regarding that project, like linking a task to a doc for status tracking.

Trash

For each place, where docs can exist, there is a dedicated trash section, which stores docs that have been moved to trash. They are only accessible via the sidebar. This means that there is a trash for private docs , a trash for space docs and a trash for project docs. Docs in a trash can be restored (up to one year) or can be perma-deleted individually.

☝️ Now that you understand the general structure of our documentation system, you can easily manage and organize your docs in a way that works best for you and your team. If you have any further questions or need assistance, please don't hesitate to reach out to our support team. 🚀

Docs main page

The docs main page is the central hub for navigating and working with your docs. It provides easy access to your docs and allows you to organize them into different spaces and projects.

Sidebar

The docs sidebar is the main element for navigating, nesting and working with your docs. It is located on the left side of the screen and provides quick access to all of your docs, favorites, trash and docs that have been shared with you.

The sidebar itself can be collapsed and expanded and has different sections, which also can be collapsed and expanded for better overview and easier navigation. These sections include:

Expand and collapse of sections and doc items

One of the features of the docs sidebar is the ability to expand and collapse sections, spaces and doc items. This means that you can choose to view only the items that are relevant to you, making it easier to find what you need. The state of these items will be saved, for each location where you work with docs.

Reordering & nesting docs

Another useful feature of our product is the ability to drag and drop items in the sidebar. This allows you to reorder spaces and docs according to your preference. To do this, simply click and hold on the item you want to move, then drag it to the desired position.

A placeholder will show where the item will be positioned, making it easier for you to place it accurately.

But that's not all - our drag and drop feature also includes an indent mechanism. This means that you can move an item to the right while dragging, and it will be placed as a sub doc. This is useful for organizing your docs into levels and subdocs. When you indent on a doc, that didn’t have subdocs yet, you see the small arrow appearing on the left, indicating your moved doc will become a subdoc.

With these drag and drop features, you have complete control over the organization of your spaces and docs, making it easier for you to access the information you need.

Spaces

Here is your access to your spaces, which hold your docs. Clicking a space navigates into it and loads the first doc in view. To add a new space, hover over the spaces section title and click the add button. Here you can customize the appearance and set your permissions regarding workspace, users and teams. To edit an existing space, hover the space and click on the three dots button.

Favourites

You can mark your most important or loved docs as favourites and they will appear in this section to guarantee fast and easy access. There are two options to mark and unmark a doc as favourite. Via the action bar in the top of a doc, or via the (three dots) more button opening the context menu.

Shared with me

Docs that have been shared with you, your team or your whole workspace, will appear in this section.

Trash

On the bottom you can always find the trash, no matter where you are. On the main sidebar the trash is your personal trash for all your deleted private docs.

Recent Docs

The recent docs section displays a list of docs that have been recently edited by you. When switching between many docs this section will be your friend.

☝️Note: Please note that there is no custom ordering available in this section.

Doc page

The doc page is the main area to view and edit your content. It is where you can create, organize, and share your docs. In this article, we will go over the different features and functions of the doc page.

Top Bar

The top bar is located at the top of the doc page and contains important buttons and information.

Add doc button

The primary blue button to add docs is in the top-left position.

Breadcrumbs

We display breadcrumbs on the left side of the top bar, indicating the location and level of your doc. The first item shows whether the doc is in a space, a project or a private doc.
You can navigate by clicking on breadcrumbs items. That open the doc and refresh the sidebar accordingly.

Action bar

The action bar is place on the right side of the top bar and offers important actions regarding your opened doc. You can mark it as favourite, share it with others, manage your watcher settings and search content inside of a doc.

Clicking the three dots more button, will open the context-menu with more options like move a doc, duplicate, copy link or delete the doc.

Title & content

This is the area where all the content of your doc live. Here you can write, document, brainstorm, collaborate together and write comments.

Our editor supports all functionality, that you know from task- and project-descriptions fields.

We also added more great features. 👉 See section below Editor features.

Title & emoji

The title and content section is where you can add and edit the title and content of your doc. You can add an emoji to the title of your doc by clicking the Add icon/emoji button.

Table of contents

When structuring content with different header formats, they will appear as small indicators at the right of the screen inside a doc. The blue indicator shows the heading which is on top of the currently visible content.

When moving the mouse to the right of the screen a popup appears, showing all used headers in your doc. Clicking a header from the popup navigates to that section of the doc.

☝️Hint: Table of contents is always visible and cannot be turned off.

Create a doc

There are different options to create a new doc, based on where you are in awork and what kind of doc you want to create.

Primary button

You can create a new doc via the primary blue + Doc button in the top left of the page. This button is visible on the the docs main page, when inside of a space or in the project doc tab page.

Clicking that button will always create a doc in the same level as the currently displayed one. If you want to directly create subdocs, you need to use the small + button on a doc item in the sidebar.

Create subdocs

In addition to the primary button, there are also smaller add-buttons within the doc-items, that appear on hover. These buttons allow you to create a subdoc for a specific doc.
The correct location of the doc is immediately shown in the breadcrumbs.

☝️ Hint: You can also manually reorder and nest docs in the sidebar via drag and drop.

Create a private doc

Go to docs main page, and click the + Doc button, to create a private doc.

Move a Doc

If you need to move your doc to a different space, project, or make it private, you can do so by using the move feature. This can be accessed via the context-menu on the doc and allows you to easily move your around in your workspace.

In the move popup you can select a location from the tab bar. (Space, Project, Private,). Clicking Move here now will move the doc in the top-level hierachy of the selected location. If you want to move it, to become a subdoc of another doc, you can select the doc inside of the popup. When move action is triggered now, it becomes a subdoc.

Share a doc

You can easily share your doc with others by using the share button in the action bar or via the context menu. This allows you to set workspace access, assign teams and users to your doc. While sharing, you can can define individual permission settings for each user or team. All docs can be individually shared.

Delete a doc

Each doc type has their own trash section, which is always the last section of the doc sidebar. For space docs the trash can be accessed from inside of the space, for project docs it is found in the project doc sidebar. And the trash for your private docs, can be accessed in the sidebar from the main docs page.

Once a doc is moved to trash, all its subdocs are also moved there as well. Docs in trash cannot be edited and will be permanently deleted after one year.

Docs and subdoc can be individually restored back to its original place via the context-menu and clicking Restore.

☝️Important: When perma-delete a doc via the context-menu from the trash, it will be gone forever with all its subdocs and cannot be restored anymore.

Doc features

Live edit collaboration

Collaborating on docs via live edit makes working on docs together super easy. Other users are visible via the live user indicators, while they are typing or selecting text.

Link task to a doc

Project docs have have a special feature, to link a task to a doc. Click on the placeholder text Select task below the title of a project doc, and select a task of the project or create a new one.
The task will be added and linked to the doc until manually unlinked again, which can be done on the (x) of the task or via the doc context-menu.

The current task status of the linked task will be shown on the docs item in the sidebar.


☝️Note: Only one task can be linked to a project doc at the same time.

Create tasks via AI

A handy feature is the ability to create tasks based on the content of a text selection inside of a doc. Mark some text, click the Create tasks button in the toolbar and select the project and tasklist for the tasks to be placed.

Comments on docs

To create a comment on a doc, mark some text and click on the comment button in the toolbar. This will start a new comment thread for this text selection. You can mention users, reply on comments, react on comments and of course edit and delete your comments as well.

A comment thread will stays unless it is marked as resolved. When deleting the first comment of a thread, the whole thread will be removed.
Mentioned users will be notified and at the top right of a comment popup, you can click to copy the link of a thread for easier sharing.

Search for docs

Docs can be searched and found via the global search. There is a dedicated Docs tab in the search, to filter the results only for docs.

☝️ Note: Docs in trash can still be found via the global search.

Did this answer your question?