1. Lack of information.
- Lack of console screenshots for topics about console element
- Lack of steps for different operating systems
- Lack of detailed guidance, but only with ambiguous information
- Lack of description about architecture or how to work
- Command variables are not explained
- Diagram is not in detail
2. Wrong information.
- Typo errors
- Information in docs is not consistent with user’s environment
- Outdated product names
- Information in docs is wrong itself
3. Confusing information.
- Steps are not in details. Users might have different understandings
- Terms with the same meaning, but with different names
- Commands with variables and designated values, but without explanations.
4. Other feedbacks.
- Broken Links
- Slower loading speeds than before
- Bad search results
5. Improvement solutions:
- Peer review process is necessary.
- Adopt more automatic Acrolinx and broken link checking process, and ensure each docs pass Acrolinx and broken link checking before they are published.
- Pain points, peer review results, and best practices discussion and sharing.
- Most users use the search function in Docs site, instead of Google search.
- Investigate the search function in Docs site, and summarize the problems for improvements.
- More convenient communication channels with Sales, pre-sales support, post-sales support team to get more real-time feedbacks more quickly and easily.
- Add more high-quality topics to help users have a better understanding of the architecture, concept, purpose, workflow graph, use scenarios for each feature, security concerns,etc, instead of providing only the procedure to complete a task.
- Get the email address of the users that provide negative feedbacks, and check
with them for detailed suggestions.