Documents

Documents are the main object type in the Knowledge Manager Bot. They contain a title and a content.

Structure

Documents are structured inside of topics, but it is not necessary to place a document in a topic. They can also live outside of topics. Each topic is placed inside of a project.

This creates the following tree structure:

Project 1
    └── Topic 1
        └── Document 1
        └── Document 2
        └── Document 3
    └── Topic 2
        └── Document 4
        └── Document 5
        └── Document 6
Project 2
    └── Topic 3
        └── Document 7
        └── Document 8
        └── Document 9

Markdown formatting

Every Document content has multiple options for formatting. The formatting standard is Markdown, but not every feature is support.

Headings

You can structure your document by having 3 level of headings. Each Heading level is represented by a # at the beginning of the line.

# Heading 1
## Heading 2
### Heading 3

Bold

You can make text bold by surrounding it with **.

**Bold text**

Italic

You can make text italic by surrounding it with *.

*Italic text*

Bold and Italic

You can make text bold and italic by surrounding it with ***.

***Bold and italic text***

You can add links to your document by surrounding the text you want to link with [ and ] and the link with ( and ).

[Link text](https://www.example.com)

Images

You can add images to your document by surrounding the alt text with [ and ] and the image URL with ( and ) and prefixing it with a !.

![Alt text](https://www.example.com/image.png)

If you want to use images in a public document via Bnder pages, the image needs to be served via our CDN. To do so, you can upload the image to the File storage and make it public. Then copy the public URL and use it in your document.

Commands

Create a document

Opens a dialog to create a new document with title and content.
/document create
Knowledge Manager
Requires MANAGE_DOCUMENTS permissions

Read a document

Displays the content and title of a document
/document read
document
my document
Knowledge Manager
Requires READ_DOCUMENTS permissions

Get Document info

Displays meta information about a document. This includes creator, creation date, last edit date and more.
/document info
document
my document
Knowledge Manager
Requires READ_DOCUMENTS permissions

List all documents

/document list
project
my project
label
my label
Knowledge Manager

Edit a document

Opens a dialog box where the title and content of a document can be edited.
/document edit
document
my document
Knowledge Manager
Requires MANAGE_DOCUMENTS permissions

Delete a document

Provides a confirmation message where a document can be moved to a trash bin or deleted permanently.
/document delete
document
my document
Knowledge Manager
Requires MANAGE_DOCUMENTS permissions

Restore a document

Restores a document from the trash bin.
/document restore
document
my document
Knowledge Manager
Requires MANAGE_DOCUMENTS permissions

Change the topic of a document

Changes the topic of a document. This is useful to group documents by topic.
/document topic
document
my document
topic
my topic
Knowledge Manager
Requires MANAGE_DOCUMENTS permissions