--- title: "What's new | Writers' Toolkit documentation" description: "A summary of notable changes to Writers' Toolkit guidance." --- > For a curated documentation index, see [llms.txt](/llms.txt). For the complete documentation index, see [llms-full.txt](/llms-full.txt). # What’s new This page provides a summary of notable changes to Writers’ Toolkit guidance. ## March 2026 Expand table | New guidance or change | Page | |--------------------------------------|------------------------------------------------------------------------| | Added `docs/alloy-config` shortcode. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#docsalloy-config) | | Added `datatable` code block type. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#datatable) | | Added `mermaid` to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#mermaid) | ## February 2026 Expand table | New guidance or change | Page | |-----------------------------------|----------------------------------------------------------------| | Added `api-tree` code block type. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#api-tree) | ## January 2026 Expand table | New guidance or change | Page | |-----------------------------------------------------------------|-----------------------------------------------------------------------------| | Added information about Grafana Cloud deep links to Links page. | [Links](/docs/writers-toolkit/write/links/#link-to-grafana-cloud-resources) | ## December 2025 Expand table | New guidance or change | Page | |-------------------------------------------|---------------------------------------------------------------| | Added a Security page to the Style Guide. | [Security](/docs/writers-toolkit/write/style-guide/security/) | ## November 2025 Expand table | New guidance or change | Page | |------------------------------------------------------|-----------------------------------------------------------------------------| | Added scenario topic type and examples. | [Scenario topic](/docs/writers-toolkit/structure/topic-types/scenario/) | | Added `image-map` to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#image-map) | | Added `annotated` code blocks to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#annotated-code-block) | | Added editable code placeholders to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#editable-placeholders) | ## July 2025 Expand table | New guidance or change | Page | |-----------------------------------|-------------------------------------------------------------| | Added `badge` to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#badge) | ## March 2025 Expand table | New guidance or change | Page | |------------------------------------------------------------|------------------------------------------------------------------------------------------------| | Updated screenshot guidelines with resolution information. | [Screenshot guidelines](/docs/writers-toolkit/write/image-guidelines/#screenshot-guidelines-1) | ## February 2025 Expand table | 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](https://raw.githubusercontent.com/grafana/writers-toolkit/refs/heads/main/docs/static/templates/section-template.md) | | Added `topic/` Make targets to create a topic from its template | [Topic types](/docs/writers-toolkit/structure/topic-types/) | | Added `video-embed` to Shortcodes page. | [Shortcodes](/docs/writers-toolkit/write/shortcodes/#video-embed) | | Added examples to screenshot guidelines | [Screenshot guidelines](/docs/writers-toolkit/write/image-guidelines/#screenshot-examples) | ## January 2025 Expand table | New guidance or change | Page | |-----------------------------------------------------------------------------------------------------------------------------------------------|---------------------------------------------------------------------------------| | Updated the release life cycle stages labels to match those documented in [Release life cycle for Grafana Labs](/docs/release-life-cycle/). | [Labels](/docs/writers-toolkit/write/front-matter/#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](/docs/writers-toolkit/write/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](/docs/writers-toolkit/write/shortcodes/#column-list) | ## November 2024 Expand table | New guidance or change | Page | |----------------------------------------------------------------------------------|--------------------------------------------------------------------------| | Added *drawer* to UI elements and updated description and image for *main menu*. | [UI elements list](/docs/writers-toolkit/write/style-guide/ui-elements/) | ## October 2024 Expand table | New guidance or change | Page | |-----------------------------------------------------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Added `column-list` shortcode that renders lists in multiple columns. | [Shortcodes - Column-list](/docs/writers-toolkit/write/shortcodes/#column-list) | | Added guidance to use paragraphs in What’s new notes. | [Guidelines for What’s new content](/docs/writers-toolkit/contribute/release-notes/#guidelines-for-whats-new-content) | | Added *kebab case* and *single pane of glass* to word list. | [Word list - kebab case](/docs/writers-toolkit/write/style-guide/word-list/#kebab-case) and [Word list - single pane of glass](/docs/writers-toolkit/write/style-guide/word-list/#single-pane-of-glass) | | Added second menu icon image to UI elements list. | [UI elements list](/docs/writers-toolkit/write/style-guide/ui-elements/) | | Removed “main menu” from menu icon description in UI elements list. | [UI elements list](/docs/writers-toolkit/write/style-guide/ui-elements/) | ## September 2024 Expand table | New guidance or change | Page | |----------------------------------------------------------------------------------------------|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------| | Added preference for *end-to-end* when talking about testing. | [Word list](/docs/writers-toolkit/write/style-guide/word-list/#end-to-end) | | Added preference for *meta-monitoring* when talking about monitoring other monitoring tools. | [Word list](/docs/writers-toolkit/write/style-guide/word-list/#meta-monitoring) | | Added preference for use of *self-managed* when talking about Grafana deployment methods. | [Word list](/docs/writers-toolkit/write/style-guide/word-list/#self-managed) | | Added preference to use the title *Best practices* for best practice guidelines | [Concept](/docs/writers-toolkit/structure/topic-types/concept/#concept-topic-structure) and [Word list](/docs/writers-toolkit/write/style-guide/word-list/#best-practices) | ## August 2024 Expand table | New guidance or change | Page | |---------------------------------------------------------------------------------------------------------|-----------------------------------------------------------------------------------------------| | Added documentation for Grot guides. | [Grot guides](/docs/writers-toolkit/write/grot-guides/) | | Revised Vale rule for use of exclamation marks and reduced its Vale severity from “error” to “warning”. | [`Grafana.Exclamation`](/docs/writers-toolkit/review/lint-prose/rules/#grafanaexclamation) | | 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](/docs/writers-toolkit/write/image-guidelines/#image-and-diagram-standards) |