Template for new entries
Copy this structure when creating a new wiki entry. You don't have to fill everything in — it's a starting point so you never begin from scratch.
markdown
# Topic title
One or two sentences: what this is and why it matters to me as a QA.
## Context
Where I ran into this (project, course, article) and what problem it solves.
## The main idea
An explanation in my own words. If I can't explain it simply,
I don't fully understand it yet.
## Practical example
A concrete case, ideally from my day-to-day work.
## How I apply it
- Checklist or actionable steps.
## Common mistakes / things that surprised me
- ...
## References
- [Link to the source](https://...)Wiki conventions
- One
.mdfile per topic, in its category folder (docs/fundamentals/,docs/api-testing/…). - File name: lowercase with hyphens —
my-new-topic.md. - Add the page to the sidebar: add
{ "text": "...", "link": "/category/my-new-topic" }to its section indocs/.vitepress/sidebar.json— or do it from the CMS at/admin/("Sections & sidebar"). Links to pages that don't exist yet are hidden until the page is created, so order doesn't matter. - For a new category: add a section to
docs/.vitepress/sidebar.json(give itnavanddirto get a top-menu entry and its own CMS collection) and createdocs/<dir>/index.md— again, doable entirely from/admin/. - Write in my own words: the wiki is worth what I understand, not what I copy.
- Two recurring example domains: the wiki's examples use a threat modeling platform and a telecommunications operator as fictional domains, so they speak the language of real projects without naming companies or products.