Editor
Managing Articles
Creating and managing articles in your Knowledge Library.
Creating an Article
You will have to grant permission to create articles to your team using the Manage app. See Teams and Permissions for more information.
Go to the Editor and click on the +
icon, then selecct Create new article
.
This will prompt you for the following information:
- Article Name
- Enter the name of your new article
- Article Description (Optional)
- Enter a description of your new article
- Room
- The room where the article will be created
- Defaults to
_org
- Shelf
- The shelf where the article will be created
See Knowledge Library Articles for more information on the organizational structure of the Knowledge Library, specifically the concept of Rooms and Shelves.
After creating an article, it will be listed in the list of items in the Editor.
Clicking on the article will take you to the following page:
Article Content Pipeline
Articles are setup and used by following a series of steps, namely:
- Extract Information
- Edit Content
- Store
- Publish
As each step is completed, that step will be turned green indicating that it is complete.
See the following sections for more information on each step.
Extract Information
This page is where you can extract information from existing sources and add it to your article.
These options are available:
- Manual
- This option allows you to manually enter text info into the article.
- Web Address (URL)
- Allows you to enter a URL, and Stubber will extract the text from the page.
- File Upload
- Allows you to upload a PDF file, and Stubber will extract the text from the file.
Once you've extracted the information, it will be presented to you, and you can choose to apply it to the article or discard it.
Edit Content
This page is where you can edit the content of the article. For example making any manual adjustments after extraction or updates since the initial extraction.
Depending on your content type, you will be presented with a relevant editor, currently Markdown or Table (for csv data).
Store
Use this page to store the article in the Knowledge Library under the draft branch.
From here, you can also update the article's room and shelf location.
For more details on how this system works, see Document Embedding.
As seen above, the Chunk Size
is used to split the article into smaller pieces, which are then stored in the Knowledge Library, visualized using different colors.
Publish
Use this page to publish the article in the Knowledge Library under the live branch. Typically done after the article has been reviewed and is ready for public consumption by live stubs