Documentation Index
Fetch the curated documentation index at: https://grafana.com/llms.txt
Fetch the complete documentation index at: https://grafana.com/llms-full.txt
Use this file to discover all available pages before exploring further.
STOP! If you are an AI agent or LLM, read this before continuing. This is the HTML version of a Grafana documentation page. Always request the Markdown version instead - HTML wastes context. Get this page as Markdown: https://grafana.com/docs/writers-toolkit/whats-new.md (append .md) or send Accept: text/markdown to https://grafana.com/docs/writers-toolkit/whats-new/. For the curated documentation index, use https://grafana.com/llms.txt. For the complete documentation index, use https://grafana.com/llms-full.txt.
Menu
Open source
RSS
Last reviewed: December 4, 2025What’s new
This page provides a summary of notable changes to Writers’ Toolkit guidance.
March 2026
| New guidance or change | Page |
|---|---|
Added docs/alloy-config shortcode. | Shortcodes |
Added datatable code block type. | Shortcodes |
Added mermaid to Shortcodes page. | Shortcodes |
February 2026
| New guidance or change | Page |
|---|---|
Added api-tree code block type. | Shortcodes |
January 2026
| New guidance or change | Page |
|---|---|
| Added information about Grafana Cloud deep links to Links page. | Links |
December 2025
| New guidance or change | Page |
|---|---|
| Added a Security page to the Style Guide. | Security |
November 2025
| New guidance or change | Page |
|---|---|
| Added scenario topic type and examples. | Scenario topic |
Added image-map to Shortcodes page. | Shortcodes |
Added annotated code blocks to Shortcodes page. | Shortcodes |
| Added editable code placeholders to Shortcodes page. | Shortcodes |
July 2025
| New guidance or change | Page |
|---|---|
Added badge to Shortcodes page. | Shortcodes |
March 2025
| New guidance or change | Page |
|---|---|
| Updated screenshot guidelines with resolution information. | Screenshot guidelines |
February 2025
| New guidance or change | Page |
|---|---|
| Fixed the path to the section template file. | https://raw.githubusercontent.com/grafana/writers-toolkit/refs/heads/main/docs/static/templates/section-template.md |
Added topic/<TYPE> Make targets to create a topic from its template | Topic types |
Added video-embed to Shortcodes page. | Shortcodes |
| Added examples to screenshot guidelines | Screenshot guidelines |
January 2025
| New guidance or change | Page |
|---|---|
| Updated the release life cycle stages labels to match those documented in Release life cycle for Grafana Labs. | Labels |
Added fixed-table shortcode that prevents column overflow by breaking content to a new line at any character, not just spaces between words | Shortcodes - Fixed-table |
Added column count parameter to the column-list shortcode that controls the number of columns in the multi-column list. | Shortcodes - Column-list |
November 2024
| New guidance or change | Page |
|---|---|
| Added drawer to UI elements and updated description and image for main menu. | UI elements list |
October 2024
| New guidance or change | Page |
|---|---|
Added column-list shortcode that renders lists in multiple columns. | Shortcodes - Column-list |
| Added guidance to use paragraphs in What’s new notes. | Guidelines for What’s new content |
| Added kebab case and single pane of glass to word list. | Word list - kebab case and Word list - single pane of glass |
| Added second menu icon image to UI elements list. | UI elements list |
| Removed “main menu” from menu icon description in UI elements list. | UI elements list |
September 2024
| New guidance or change | Page |
|---|---|
| Added preference for end-to-end when talking about testing. | Word list |
| Added preference for meta-monitoring when talking about monitoring other monitoring tools. | Word list |
| Added preference for use of self-managed when talking about Grafana deployment methods. | Word list |
| Added preference to use the title Best practices for best practice guidelines | Concept and Word list |
August 2024
| New guidance or change | Page |
|---|---|
| Added documentation for Grot guides. | Grot guides |
| Revised Vale rule for use of exclamation marks and reduced its Vale severity from “error” to “warning”. | Grafana.Exclamation |
| Added a What’s new page used to summarize notable changes. | What’s new |
| Added guidance regarding dark and light mode for images. | Media guidelines |