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 |