https://peertube.watch/videos/watch/fd63f4e0-404c-47b2-8e79-a34c109baef6 Taming Abstraction: Tool-led d.r.y. vs sane and readable docs source without too much duplication What is the best balance for a docs team who has to maintain the docs and outside contributors who need to understand before they can contribute? (And are there workarounds to help reviewers who are not so familiar with Antora or your chosen tool & methodology?) [Examples will be shown from the many Apache-licensed, public docs repos at https://github.com/couchbase/ ] Speaker: Richard Smedley, Track: Tool the docs devroom, Room: K.4.601, When: Saturday 3 February 2024, 15:45–16:10 (Brussels time), Schedule: FOSDEM 2024 event page, Slides & links Background slides to open question - balancing abstraction level between the needs of random contributors to understand quickly, and of under resourced maintainers to automate away repetitive work., Licence: Creative Commons Attribution 2.0 Belgium (CC BY 2.0 BE) (as stated in the FOSDEM video archive). Attribution: “Taming Abstraction” by Richard Smedley, FOSDEM 2024. Original recording: 2024/k4601/fosdem-2024-2320-taming-abstraction.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:03:41 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/fd63f4e0-404c-47b2-8e79-a34c109baef6 All rights reserved, unless otherwise specified in the terms specified at https://peertube.watch/about and potential licenses granted by each content's rightholder.