<?xml version="1.0" encoding="utf-8"?>
<feed xmlns="http://www.w3.org/2005/Atom">
    <id>https://dirthara.github.io/docs/blog</id>
    <title>Dirthara</title>
    <updated>2026-09-10T00:00:00.000Z</updated>
    <generator>https://github.com/jpmonette/feed</generator>
    <link rel="alternate" href="https://dirthara.github.io/docs/blog"/>
    <subtitle>Releases and announcements for the Dirthara packages.</subtitle>
    <icon>https://dirthara.github.io/docs/img/favicon.png</icon>
    <rights>Copyright © 2026 Dirthara</rights>
    <entry>
        <title type="html"><![CDATA[The documentation site is live]]></title>
        <id>https://dirthara.github.io/docs/blog/2026/09/10/documentation-site</id>
        <link href="https://dirthara.github.io/docs/blog/2026/09/10/documentation-site"/>
        <updated>2026-09-10T00:00:00.000Z</updated>
        <summary type="html"><![CDATA[Every Dirthara package writes its usage documentation as markdown in its own]]></summary>
        <content type="html"><![CDATA[<p>Every Dirthara package writes its usage documentation as markdown in its own
<code>docs</code> directory, next to the code it describes. That is where it belongs: a
change in behaviour and the paragraph describing it land in the same pull
request, reviewed together.</p>
<p>It is not, however, where anybody wants to read it.</p>
<!-- -->
<p>This site collects those directories and publishes them as one set of
documentation, with a category per package. The markdown is not copied here.
Each build pulls it from the package repositories at the git ref the version
pins, so a page on this site is the page that shipped with the code.</p>
<p>Documentation is published per major version. There is no <code>1.0</code> yet, so there
is one version — <code>dev</code> — built from the newest release branch of each package.
When the first major lands, <code>dev</code> keeps following the newest branch and <code>1</code>
becomes a version of its own, still built from the branch that carries it.</p>]]></content>
        <author>
            <name>Dirthara</name>
            <uri>https://github.com/dirthara</uri>
        </author>
        <category label="Documentation" term="Documentation"/>
    </entry>
</feed>