https://sergiocomeron.com/blog/en/tags/documentation/ Recent content in Documentation on Sergio Comerón Blog Hugo en Mon, 01 Jun 2026 00:00:00 +0200 https://sergiocomeron.com/blog/en/posts/mkdocs-documentacion-bilingue/ Mon, 01 Jun 2026 00:00:00 +0200 https://sergiocomeron.com/blog/en/posts/mkdocs-documentacion-bilingue/ <p>The Jitsi plugin for Moodle I maintain, <code>mod_jitsi</code>, had all of its documentation in one place: the <code>README.md</code>. And it wasn&rsquo;t just any README — it was <strong>over 600 lines</strong> covering installation, server options (GCP, JaaS, self-hosted), JWT mode, recordings, attendance, permissions… A good README, but a README nonetheless.</p> <p>The problem with a long README is that <strong>it doesn&rsquo;t scale as documentation</strong>. Nobody reads 600 lines top to bottom on GitHub. There&rsquo;s no search. No sidebar navigation. No clean way to link to &ldquo;the JWT configuration section&rdquo;. And if you want to translate it, you end up with two giant files that drift out of sync the moment you touch them.</p>