Occasionally Tettra users search for documentation to answer their questions and are unable to find the answer or realize some information is out of date. The best way to let the rest of your team know you haven't been able to find information is by opening suggestion. There are currently two types of suggestions:
- New page suggestion - a question or request to add new content to your knowledge base
- Update suggestion - a suggestion to update an existing Tettra page
Suggestions are visible to your team according to the category they are in. From the suggestions index you can see open, closed, and scheduled suggestions.
This article covers adding and answering the first type of suggestion described above: New Page Suggestions.
Creating a New page Suggestion
You can create a new suggestion at any time from the 'New' menu at the top right of any page:
After you've filled out the suggestion subscription, you can select when you'd like the suggestion to be created. Select "Now" if you'd like to immediately create the suggestion and send a notification to the assigned owner. Schedule for later if you'd like to remind yourself to check up on a doc or your team isn't ready to complete the suggestion.
Next, assign the suggestion to a specific team member. If you know who the resident expert on the subject is, assign it directly to them. It will then mention that teammate in the Slack notification that's sent out.
If you don't have a specific teammate in mind, you can leave that field as 'Not sure'. This will automatically assign the suggestion to the author of the page. At Tettra, we also create suggestions for ourselves as a reminder or 'todo' to write about something later.
If you already know what category the page belongs in you can select that as well. If you've set up notifications for each category it will then send a notification to the corresponding Slack channel.
When you create a suggestion and assign it to a category, it will appear in the lefthand sidebar under the corresponding category:
The content of your suggestion will also be visible when you choose to respond with a new page:
Once you've published the page, it will be filed in the same place where your suggestion used to live:
Each suggestion has a detail view that allows commenting, so team members can have a conversation on what information needs to be added. Team members can also 'upvote' the suggestion by clicking the thumbs-up button, to see which suggestions are most popular and should be answered first.
Responding to Suggestions
To respond to a suggestion, you can click the 'Create page' button. It will launch you right into a new draft of that page and will carry over the page title from the original request. Once you publish that page it will automatically be linked from the detail view.
You can select an existing page if you know the answer is already documented. You can also close the suggestion with a comment if the answer only needs a quick reply a not an entire new page. All suggestions and their comments are fully searchable via the search bar at top of every Tettra page, so the next person looking for that info will be able to find that comment.
Suggestions will automatically be closed when you publish a new page from a suggestion or answer with an existing page. In either scenario, Tettra will automatically add a reference to the page in the comment section. You also have the option to either 'reply' or 'comment and close' when responding to a suggestion with a comment.
If you want to close a suggestion without taking any action on it, you can do so by clicking the kebab menu to the right of the suggestion and selecting 'close'.
Deleting a Suggestion
Suggestions can only be deleted after they've been closed. To do so, navigate to the 'Closed' tab, click the kebab menu next to the closed suggestion, and select 'delete'.
Creating Suggestions In Slack
The best way to created a suggestion in slack is with message actions.
You can also create suggestions within Slack conversations using a slash command. Just type in /tettra request @[slack username] [title] .
Find more information on using slash commands in Slack for search, requests and to create pages here.