-
Notifications
You must be signed in to change notification settings - Fork 24
Introductory articles outline
When announcing a new feature or component, here's a rough outline of what is needed. This is similar to the task based guide recipe but the focus of these articles is different. Instead of a detailed step by step, it is more a high level introduction.
Problem statement: General, user-focused statement(s) describing the problem or need that the new toolkit or component addresses and the benefit they gain from using it. What will this article talk about?
Prerequisites: (optional) If there is any background information they need to understand this article, mention it here and provide links. What do they need in order to run this tool? How do they get it?
Overview Bit more detail in the tool, how to get it (e.g now available in Streams 4.x). If there are other alternatives, or similar solutions or tooling, mention these and help the user see when they would use this new tool instead of the existing component. Help them choose. Mention relevant features and the problems they solve.
Get started Show how to get set up (install/config) A couple of simple examples of usage and common configuration options Common troubleshooting (what errors might they run into?)
What next to do Link to any other content (Articles, Knowledge center) that dive deeper.