https://peertube.watch/videos/watch/698acc50-e5a9-469e-bbcf-441b3ddf6abb Defining style as code lets tools do the hard work of remembering the style and gives technical writers and engineers the feedback they need to produce better documentation. Reading good documentation is deceptively easy, and writing good documentation which is easy to read is hard. Both native and non-native English speakers find communicating useful and clear information in technical documentation is a challenge. Style guides from Google, Microsoft, and many others exist, but those are huge amounts of documentation themselves and are very difficult to memorize. In this presentation, we will cover: Why consistent style is valuable in improving inclusivity, readability, and clarity of documentation, The challenges of ensuring consistency, including managing exceptions and defining priorities of style rules., Creating clear explanations so that writers feel empowered with knowledge rather than berated with pedantry, Demonstrating open source tooling that solves these challenges using Vale, a configurable, open source tool, an extensible rule set, support for many markup languages, and editor and CI integrations., We'll also demonstrate: Getting started using existing rulesets, Specific rules written and open source by Grafana, Configuring Vale for a project, Introducing linting incrementally with reviewdog, Speaker: Jack Baldry, Track: Tool the docs devroom, Room: K.4.601, When: Saturday 3 February 2024, 15:15–15:40 (Brussels time), Schedule: FOSDEM 2024 event page, Slides & links Presentation slides, Vale, Reviewdog, Grafana Writers' Toolkit, Licence: Creative Commons Attribution 2.0 Belgium (CC BY 2.0 BE) (as stated in the FOSDEM video archive). Attribution: “Style as code: Using open source tooling to codify technical documentation style” by Jack Baldry, FOSDEM 2024. Original recording: 2024/k4601/fosdem-2024-2471-style-as-code-using-open-source-tooling-to-codify-technical-documentation-style.av1.webm from the FOSDEM video archive. This channel is an unofficial mirror; FOSDEM is a free and non-commercial event organised by the community for the community. Wed, 21 Oct 2026 23:02:21 GMT https://validator.w3.org/feed/docs/rss2.html PeerTube - https://peertube.watch https://peertube.watch/lazy-static/avatars/3b284627-b75f-409e-ac2e-10f4c2946f43.png https://peertube.watch/videos/watch/698acc50-e5a9-469e-bbcf-441b3ddf6abb All rights reserved, unless otherwise specified in the terms specified at https://peertube.watch/about and potential licenses granted by each content's rightholder.