The problem
The Internet is full of answers.
The challenge getting to that answer in a timely manner.
The first search result MAY have the answer you are looking for, but you have to read through a forum thread or wade through lengthy introductory text to get to find the answer you seek.
This consumes your time and your mental energy.
Mission
KBarticles.com aims to help readers be more efficient by formatting knowledge in a clean, concise, repeatable content pattern.
We will achieve this by applying consistent, purpose driven article formats based on type, and using a consistent writing style.
Apply the Diátaxis framework
The Diátaxis framework breaks documentation into 4 types based on reader needs:
- Tutorials: lessons.
- How-to guides: practical directions addressing a real-world goal or problem.
- Reference: facts – accurate, complete, reliable information, free of distraction and interpretation.
- Explanation: guides providing context and background.
Use a consistent writing style
Part of establishing a repeatable, recognizable content pattern is using a consistent writing style.
Articles are written applying the guidance outlined in the Microsoft Writing Style Guide.
