Best Practices for Content Creation
What is a Content Block?
Talla allows you to organize information into Content Blocks within a page. Content Blocks are denoted by H1 Headers and the content underneath each H1. A page can have multiple H1 Headers but a Content Block has only one. The Content Block can contain lists, tables, paragraphs, links, and automations. The Content Block is the unit of information evaluated and returned for any user request.
What are best practices for Content Blocks?
- A Content Block should be clear, concise, and accurate
- Each section should cover a discrete topic with unique value
- When users ask questions or search the Knowledge Base, the Content Block or Blocks that best match their request will be returned.
- If the Content Block has a large amount of information it will be truncated within chat and a link will be given to the user to view in Talla.
What is the difference between H1 and H2?
- H1 and the headers after that (H2s) are a way to organize your data.
- H2s are tied to H1s and are not currently surfaced on their own.
- H2s can help you organize different questions related to things like different product lines, upcoming sprint launch, customer success status updates, etc.
- If the knowledge block is for a Question and Answer pair be sure to set the H1 header of the Content Block as the Question and the paragraph as the answer.
- Try and have each block answer a specific question.
- For the best results for your users, consider using Who/What/Where/When/Why type questions.
Below are examples of what Content Blocks look like within a Sales Card Page for your Sales team.
H1: Header 1
H2: Header 2
This is how it would look if someone was to ask a question regarding Acme’s Elevator pitch via a chat channel, in this example I’m using Slack:
PRO TIP: When creating a page I would always use the verify option to be sure your content is kept up to date. We have several options whether it be weekly or monthly verifications. Great for product releases and FAQs that become outdated overtime.
CONTEXT: If you have multiple offices this will allow you to annotate your data based on that location. This allows Talla to be more intelligent providing answers to users specific to where they are located. Contact email@example.com to set up contexts for your team.
Don’t forget about embedding content. The Content Embedding feature allows you to construct pages from shared, authoritative Content Blocks.
This means if the information in a Block changes, you only need to update the source Block and the other pages will be updated automatically.
When a question requires a process or task, automate it with our Task Automation feature and you’ll never have to open up another application again.
Be sure to add only one Task Automation per Content Block.