Do you send links when offering support?

Last updated by Caleb Williams [SSW] 8 months ago.See history

When offering support to customers using your product, think about whether this problem has occurred before or could happen again. If it has, there should be documentation available. This not only helps customers resolve their issues faster but also reduces the repetitive workload for the support team.

You should never have to answer the same question twice. When you get a new question e.g. "Can I have co-authoring in TinaCMS?" these are the steps you should follow:

  1. Check for existing documentation.
  2. If it doesn't exist, create the documentation.
  3. Reply with a link to the documentation.

Every support message should include a link to the relevant documentation or, if applicable, to a Product Backlog Item (PBI).

Yes - you can do co-authoring in TinaCMS.
You can do it by going to your TinaCloud account settings, filling out the Git co-author name and email, and then enabling it.

Let me know if you have any issues with this!

Figure: Bad Example - explaining how to solve the problem when there are already documentation

Yes - you can do co-authoring in TinaCMS.
Here is the link to the documentation: How to enable co-author on Git commits?.

Figure: Good Example - Replying with a link

Sometimes, you might get questions about bugs, upcoming features, or other things that are not documented. In this case,

Not yet - We are still working on mermaid diagram support in TinaCMS. Check out this issue to see the status https://github.com/tinacms/tinacms/issues/4733

Figure: Good Example - Sending a link to a PBI is also acceptable

After a while, you will build a great library of documentation that customers will use to self-serve their questions. This practice will also get you to read your documentation and improve it more often.

Exceptions to this rule:

  • Do not write a documentation page if fixing the bug and releasing a new version solves the problem. In this case, create a PBI (or find an existing one) and reply with the link to it.
  • Do not write a documentation page or PBI if the question/answer is irrelevant to your product, e.g., "Next.js - how do I deploy my app?" (This is not relevant to TinaCMS.)

🤖 AI Tip: Consider training a chatbot on your documentation to help answer common questions automatically. Learn more about implementing a chatbot


We open source.Loving SSW Rules? Star us on GitHub. Star
Stand by... we're migrating this site to TinaCMS