--- title: Wayland 1.25 Documentation Update | daily.dev description: Wayland 1.25 ships a significant documentation overhaul after years of neglect. Three new chapters were added: an official specification of the Wayland XML... canonical: https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39 twitter:card: summary_large_image twitter:site: @dailydotdev og:type: website og:site_name: daily.dev og:title: Wayland 1.25 Documentation Update | daily.dev og:description: Wayland 1.25 ships a significant documentation overhaul after years of neglect. Three new chapters were added: an official specification of the Wayland XML... og:url: https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39 og:image: https://api.daily.dev/og/posts/EUCklZm39.png og:image:alt: Wayland 1.25 Documentation Update og:image:width: 1200 og:image:height: 630 og:locale: en --- > ## Documentation Index > Fetch the complete documentation index at: https://daily.dev/llms.txt > Use this file to discover all available pages before exploring further. # Wayland 1.25 Documentation Update **[Collabora Blog](https://daily.dev/sources/collabora)** · 3 min read · 0 upvotes · 0 comments ## Summary Wayland 1.25 ships a significant documentation overhaul after years of neglect. Three new chapters were added: an official specification of the Wayland XML dialect (helping protocol authors and code-generation tool developers), a rewrite of wl_surface content update semantics (fixing long-standing inaccuracies around nested sub-surfaces), and a color management chapter. The documentation was also migrated from DocBook XML to mdBook (Markdown-based, familiar from Rust docs), lowering the barrier to contributions. Some DocBook-generated reference content from wayland.xml and Doxygen remains and may be converted in the future. ## Full article daily.dev links to this article rather than hosting it. Read it at the original source: ## Questions this post answers ### What documentation changes were made in Wayland 1.25? Wayland 1.25 added three new documentation chapters: an official specification of the Wayland XML dialect, a rewrite of wl_surface content update semantics (fixing incorrect descriptions of nested sub-surface behavior), and a color management chapter. The documentation was also migrated from DocBook XML to mdBook (Markdown), lowering the barrier to contributions. Some DocBook-generated reference content from wayland.xml and Doxygen still remains. _Wayland protocol developers tracking ecosystem changes like these find the latest coverage on daily.dev._ ### Why was the Wayland documentation migrated from DocBook to mdBook? DocBook XML was considered a high barrier to contributing to Wayland documentation. The migration to mdBook — the same format used by Rust documentation — gives the Wayland docs a modern look and makes editing easier since content is now written in Markdown. A temporary conversion tool was used and can be found in the git history. _Those contributing to open source graphics stack docs can follow tooling and format discussions on daily.dev._ ## Similar posts on daily.dev - [Wayland 1.25 RC1 Released With Improved Documentation, Minor Changes](https://daily.dev/posts/wayland-1-25-rc1-released-with-improved-documentation-minor-changes-yzmeenxd2) · Phoronix · 0 upvotes · 0 comments - [Wayland 1.25 Released With Color Management Now Fully Documented](https://daily.dev/posts/wayland-1-25-released-with-color-management-now-fully-documented-pjg6cehpw) · Phoronix · 0 upvotes · 0 comments - [Wayland Protocols 1.46 Released With New Experimental Additions](https://daily.dev/posts/wayland-protocols-1-46-released-with-new-experimental-additions-dffczsywk) · Phoronix · 0 upvotes · 0 comments - [Ubuntu 25.10 Scraps X11 for Wayland: A Solid Step Forward](https://daily.dev/posts/ubuntu-25-10-scraps-x11-for-wayland-a-solid-step-forward-6c2jvnb08) · The New Stack · 1 upvotes · 0 comments --- Tags: [#linux](https://daily.dev/tags/linux) [View this post on daily.dev](https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39) ```json {"@context":"https://schema.org","@graph":[{"@type":"Organization","@id":"https://daily.dev/#organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180},"sameAs":["https://twitter.com/dailydotdev","https://github.com/dailydotdev","https://www.linkedin.com/company/daily-dev-ltd"]},{"@type":"WebSite","@id":"https://daily.dev/#website","url":"https://daily.dev","name":"daily.dev","publisher":{"@id":"https://daily.dev/#organization"},"potentialAction":{"@type":"SearchAction","target":{"@type":"EntryPoint","urlTemplate":"https://daily.dev/search?q={search_term_string}"},"query-input":"required name=search_term_string"}}]} {"@context":"https://schema.org","@type":"TechArticle","headline":"Wayland 1.25 Documentation Update","url":"https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39","mainEntityOfPage":{"@type":"WebPage","@id":"https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39"},"datePublished":"2026-08-11T08:57:20.072Z","dateModified":"2026-08-11T09:32:51.520Z","description":"Wayland 1.25 ships a significant documentation overhaul after years of neglect. Three new chapters were added: an official specification of the Wayland XML...","image":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/96d6b704315c0f69d10072bec355d7e5?_a=AQAEuop","thumbnailUrl":"https://media.daily.dev/image/upload/f_auto,q_auto/v1/posts/96d6b704315c0f69d10072bec355d7e5?_a=AQAEuop","isAccessibleForFree":true,"articleSection":"Collabora Blog","inLanguage":"en","publisher":{"@type":"Organization","name":"daily.dev","url":"https://daily.dev","logo":{"@type":"ImageObject","url":"https://daily.dev/apple-touch-icon.png","width":180,"height":180}},"author":{"@type":"Organization","name":"Collabora Blog","logo":"https://media.daily.dev/image/upload/s--ZGZ0FjqS--/f_auto,q_auto/v1786438306/logos/collabora?_a=BAMAMicg0","url":"https://daily.dev/sources/collabora"},"commentCount":0,"discussionUrl":"https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39","interactionStatistic":[{"@type":"InteractionCounter","interactionType":{"@type":"LikeAction"},"userInteractionCount":0},{"@type":"InteractionCounter","interactionType":{"@type":"CommentAction"},"userInteractionCount":0}],"keywords":"linux","timeRequired":"PT3M"} {"@context":"https://schema.org","@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://daily.dev"},{"@type":"ListItem","position":2,"name":"Collabora Blog","item":"https://daily.dev/sources/collabora"},{"@type":"ListItem","position":3,"name":"Wayland 1.25 Documentation Update"}]} {"@context":"https://schema.org","@type":"FAQPage","@id":"https://daily.dev/posts/wayland-1-25-documentation-update-eucklzm39#faq","mainEntity":[{"@type":"Question","name":"What documentation changes were made in Wayland 1.25?","acceptedAnswer":{"@type":"Answer","text":"Wayland 1.25 added three new documentation chapters: an official specification of the Wayland XML dialect, a rewrite of wl_surface content update semantics (fixing incorrect descriptions of nested sub-surface behavior), and a color management chapter. The documentation was also migrated from DocBook XML to mdBook (Markdown), lowering the barrier to contributions. Some DocBook-generated reference content from wayland.xml and Doxygen still remains. Wayland protocol developers tracking ecosystem changes like these find the latest coverage on daily.dev."}},{"@type":"Question","name":"Why was the Wayland documentation migrated from DocBook to mdBook?","acceptedAnswer":{"@type":"Answer","text":"DocBook XML was considered a high barrier to contributing to Wayland documentation. The migration to mdBook — the same format used by Rust documentation — gives the Wayland docs a modern look and makes editing easier since content is now written in Markdown. A temporary conversion tool was used and can be found in the git history. Those contributing to open source graphics stack docs can follow tooling and format discussions on daily.dev."}}]} ```