<!doctype html>
<html lang="en">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>CONTRIBUTING.md - fork/gdu @ master</title>
<meta name="description" content="CONTRIBUTING.md in fork/gdu at master.">
<meta property="og:title" content="CONTRIBUTING.md - fork/gdu @ master">
<meta property="og:description" content="CONTRIBUTING.md in fork/gdu at master.">
<meta property="og:type" content="website">
<meta property="og:site_name" content="git.julia.blue">
<link rel="stylesheet" href="/css/style.css?v=62">
<script type="module" src="/js/main.js?v=62"></script>
</head>
<body>
<main data-ref="master" data-tip="c636c61a7fb7f1f9a9ac9306790b41a011cbabb9">
<noscript>
  <div class="callout">
    <p>
      hey! this is a static git repo viewer. commit diffs, file history,
      older commits and other revisions won't load without javascript.
    </p>
    <p>
      you are still able to view source files on branch/tag tips,
      but the experience is degraded.
    </p>
  </div>
</noscript>
<header class="repo"><div>
<h1>fork/gdu</h1>
</div>
<pre class="clone">git clone https://git.julia.blue/fork/gdu</pre>
</header>
<p class="snapshot-commit"><span class="commit-author">Daniel Milde</span><span class="commit-message" data-commit="43b9a12c9f8cdb7e2f8df2caf5c788608f7e8756">ci: bump version of golang (#650)</span><span class="snapshot-sha sha" data-commit="43b9a12c9f8cdb7e2f8df2caf5c788608f7e8756">43b9a12</span><time datetime="2026-09-01T16:44:55+02:00" title="2026-09-01 16:44:55 +0200">2026-09-01</time></p>
<header class="topbar"><details class="switcher"><summary>master</summary><div class="menu"><strong>branches</strong><a href="/fork/gdu/ref/ignore/">ignore</a><a class="current" href="/fork/gdu/ref/master/">master</a><a href="/fork/gdu/ref/subvolume/">subvolume</a><a class="all" href="/fork/gdu/refs">all refs →</a></div></details><nav class="crumbs"><a href="/fork/gdu/">gdu</a> / <span class="cur">CONTRIBUTING.md</span></nav>
<span class="view-stats"><span>4.0 KiB</span><span>117 lines</span></span><span class="actions"><a class="raw" href="/fork/gdu/raw/2be7298128c4708146e355f025829afffa876c28/CONTRIBUTING.md">raw</a></span></header>
<div class="markdown-view"><input type="radio" name="markdown-view" id="markdown-rendered" checked><label for="markdown-rendered">rendered</label><input type="radio" name="markdown-view" id="markdown-code"><label for="markdown-code">code</label><section class="readme rendered"><h1>Contributing to gdu</h1>
<p>Thanks for your interest in contributing. This guide describes how the project
is developed so your change fits in with the rest of the codebase.</p>
<h2>Prerequisites</h2>
<ul>
<li><strong>Go</strong> 1.26 or newer (development happens on 1.27; CI runs 1.26.x and 1.27.x). The pinned toolchain is in <code>.tool-versions</code>.</li>
<li><strong>Node.js</strong> — only needed if you change the web UI (<code>webui/frontend</code>). The
compiled assets in <code>webui/dist</code> are committed and embedded into the binary, so
pure-Go builds don't require Node.</li>
</ul>
<p>Install the development tools (<code>gotestsum</code>, <code>gox</code>, <code>golangci-lint</code>, ...) with:</p>
<pre class="language-bash"><a-f>make</a-f> install-dev-dependencies</pre>
<h2>Project layout</h2>
<ul>
<li><code>cmd/gdu</code> — CLI entrypoint and flag wiring.</li>
<li><code>pkg/</code> — reusable libraries: <code>analyze</code>, <code>device</code>, <code>fs</code>, <code>path</code>, <code>remove</code>,
<code>timefilter</code>, <code>annex</code>.</li>
<li><code>stdout/</code>, <code>report/</code>, <code>tui/</code> — output backends (non-interactive stdout, JSON
export/import, and the interactive terminal UI).</li>
<li><code>webui/</code> — the optional React web UI (compiled output is committed).</li>
<li><code>docs/</code>, <code>configuration.md</code>, <code>INSTALL.md</code>, <code>gdu.1.md</code> — documentation. The man
page <code>gdu.1</code> is generated from <code>gdu.1.md</code>.</li>
</ul>
<h2>Building and running</h2>
<pre class="language-bash"><a-f>make</a-f> run          <a-c># go run the CLI</a-c>
<a-f>make</a-f> build        <a-c># build a binary into dist/</a-c>
<a-f>make</a-f> build-web    <a-c># rebuild the web UI assets (requires Node.js)</a-c></pre>
<h2>Testing</h2>
<p>Tests are colocated with the code as <code>*_test.go</code>. Platform-specific tests use
suffixes such as <code>*_linux_test.go</code> and <code>*_windows.go</code>; keep OS-specific behavior
behind the matching build constraints.</p>
<pre class="language-bash"><a-f>make</a-f> test              <a-c># gotestsum</a-c>
<a-f>make</a-f> coverage          <a-c># race detector + coverage profile</a-c>
<a-f>make</a-f> coverage-html     <a-c># open the coverage report in a browser</a-c>
<a-f>go</a-f> test ./...          <a-c># plain go test, no extra tooling</a-c></pre>
<p>CI runs the full suite on Go 1.26.x and 1.27.x (Ubuntu, plus macOS on 1.27.x),
with the race detector, and uploads coverage to Codecov. Coverage upload is set
to fail the build on error, so add tests for new behavior and keep existing
tests passing.</p>
<h2>Linting and formatting</h2>
<p>The project uses <code>golangci-lint</code> (v2) with a strict configuration in
<code>.golangci.yml</code>. Formatting is enforced via <code>gofmt</code> and <code>goimports</code>.</p>
<pre class="language-bash"><a-f>make</a-f> lint    <a-c># golangci-lint run -c .golangci.yml</a-c>
<a-f>gofmt</a-f> <a-co>-w</a-co> .   <a-c># format</a-c></pre>
<p>Run <code>make lint</code> before opening a pull request — the same check runs in CI and
must pass.</p>
<h2>Commit messages</h2>
<p>This project follows <a href="https://www.conventionalcommits.org/">Conventional Commits</a>.
Prefix each commit subject with a type, optionally scoped:</p>
<pre>&lt;type&gt;[optional scope]: &lt;description&gt;
</pre>
<p>Common types used in this repo:</p>
<ul>
<li><code>feat:</code> — a new feature</li>
<li><code>fix:</code> — a bug fix</li>
<li><code>perf:</code> — a performance improvement</li>
<li><code>refactor:</code> — a code change that neither fixes a bug nor adds a feature</li>
<li><code>docs:</code> — documentation only</li>
<li><code>test:</code> — adding or fixing tests</li>
<li><code>chore:</code> — tooling, dependencies, and maintenance (e.g. <code>chore(deps):</code>)</li>
</ul>
<p>Examples drawn from the history:</p>
<pre>feat: stop scanning and keep partial results
fix(report): make JSON export respect -t, --depth and --summarize filters
perf: concurrent processing in sqlite analyzer
chore(deps): bump modernc.org/sqlite from 1.49.1 to 1.51.0
</pre>
<p>Keep the description in the imperative mood and lower case, with no trailing
period.</p>
<h2>Pull requests</h2>
<ul>
<li>Branch off <code>master</code> and open your pull request against <code>master</code>.</li>
<li>Pull requests are <strong>squash-merged</strong>, and the final commit subject becomes the
release changelog entry — so make it a clean Conventional Commit. GitHub
appends the PR number automatically (e.g. <code>feat: add web UI (#617)</code>).</li>
<li>Make sure <code>make lint</code> and the test suite pass locally before requesting
review.</li>
<li>Add tests and update documentation (<code>configuration.md</code>, <code>gdu.1.md</code>, etc.) when
your change affects behavior or flags.</li>
<li>Keep the change focused; unrelated refactors belong in separate PRs.</li>
</ul>
<h2>Reporting issues</h2>
<p>Use the GitHub issue templates for
<a href="/fork/gdu/ref/master/blob/.github/ISSUE_TEMPLATE/bug_report.md">bug reports</a> and
<a href="/fork/gdu/ref/master/blob/.github/ISSUE_TEMPLATE/feature_request.md">feature requests</a>. Include your gdu
version, OS, and reproduction steps for bugs.</p>
</section><div class="code-panel"><pre class="code src language-markdown"><span class="code-line"><a class="ln" id="L1" href="#L1">1</a><span class="code-text"><a-p>#</a-p> <a-tt>Contributing to gdu</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L2" href="#L2">2</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L3" href="#L3">3</a><span class="code-text">Thanks for your interest in contributing. This guide describes how the project</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L4" href="#L4">4</a><span class="code-text">is developed so your change fits in with the rest of the codebase.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L5" href="#L5">5</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L6" href="#L6">6</a><span class="code-text"><a-p>##</a-p> <a-tt>Prerequisites</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L7" href="#L7">7</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L8" href="#L8">8</a><span class="code-text"><a-p>- </a-p>**Go** 1.26 or newer (development happens on 1.27; CI runs 1.26.x and 1.27.x). The pinned toolchain is in `.tool-versions`.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L9" href="#L9">9</a><span class="code-text"><a-p>- </a-p>**Node.js** — only needed if you change the web UI (`webui/frontend`). The</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L10" href="#L10">10</a><span class="code-text"><a-p>  </a-p>compiled assets in `webui/dist` are committed and embedded into the binary, so</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L11" href="#L11">11</a><span class="code-text"><a-p>  </a-p>pure-Go builds don&#39;t require Node.</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L12" href="#L12">12</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L13" href="#L13">13</a><span class="code-text"><a-p>Install the development tools (`gotestsum`, `gox`, `golangci-lint`, ...) with:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L14" href="#L14">14</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L15" href="#L15">15</a><span class="code-text"><a-p>```</a-p><a-tl>sh</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L16" href="#L16">16</a><span class="code-text"><a-p>make install-dev-dependencies</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L17" href="#L17">17</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L18" href="#L18">18</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L19" href="#L19">19</a><span class="code-text"><a-p>## </a-p><a-tt>Project layout</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L20" href="#L20">20</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L21" href="#L21">21</a><span class="code-text"><a-p>- `cmd/gdu` — CLI entrypoint and flag wiring.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L22" href="#L22">22</a><span class="code-text"><a-p>- `pkg/` — reusable libraries: `analyze`, `device`, `fs`, `path`, `remove`,</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L23" href="#L23">23</a><span class="code-text"><a-p>  `timefilter`, `annex`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L24" href="#L24">24</a><span class="code-text"><a-p>- `stdout/`, `report/`, `tui/` — output backends (non-interactive stdout, JSON</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L25" href="#L25">25</a><span class="code-text"><a-p>  export/import, and the interactive terminal UI).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L26" href="#L26">26</a><span class="code-text"><a-p>- `webui/` — the optional React web UI (compiled output is committed).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L27" href="#L27">27</a><span class="code-text"><a-p>- `docs/`, `configuration.md`, `INSTALL.md`, `gdu.1.md` — documentation. The man</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L28" href="#L28">28</a><span class="code-text"><a-p>  page `gdu.1` is generated from `gdu.1.md`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L29" href="#L29">29</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L30" href="#L30">30</a><span class="code-text"><a-p>## </a-p><a-tt>Building and running</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L31" href="#L31">31</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L32" href="#L32">32</a><span class="code-text"><a-p>```</a-p><a-tl>sh</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L33" href="#L33">33</a><span class="code-text"><a-p>make run          # go run the CLI</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L34" href="#L34">34</a><span class="code-text"><a-p>make build        # build a binary into dist/</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L35" href="#L35">35</a><span class="code-text"><a-p>make build-web    # rebuild the web UI assets (requires Node.js)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L36" href="#L36">36</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L37" href="#L37">37</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L38" href="#L38">38</a><span class="code-text"><a-p>## </a-p><a-tt>Testing</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L39" href="#L39">39</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L40" href="#L40">40</a><span class="code-text"><a-p>Tests are colocated with the code as `*_test.go`. Platform-specific tests use</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L41" href="#L41">41</a><span class="code-text"><a-p>suffixes such as `*_linux_test.go` and `*_windows.go`; keep OS-specific behavior</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L42" href="#L42">42</a><span class="code-text"><a-p>behind the matching build constraints.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L43" href="#L43">43</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L44" href="#L44">44</a><span class="code-text"><a-p>```</a-p><a-tl>sh</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L45" href="#L45">45</a><span class="code-text"><a-p>make test              # gotestsum</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L46" href="#L46">46</a><span class="code-text"><a-p>make coverage          # race detector + coverage profile</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L47" href="#L47">47</a><span class="code-text"><a-p>make coverage-html     # open the coverage report in a browser</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L48" href="#L48">48</a><span class="code-text"><a-p>go test ./...          # plain go test, no extra tooling</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L49" href="#L49">49</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L50" href="#L50">50</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L51" href="#L51">51</a><span class="code-text"><a-p>CI runs the full suite on Go 1.26.x and 1.27.x (Ubuntu, plus macOS on 1.27.x),</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L52" href="#L52">52</a><span class="code-text"><a-p>with the race detector, and uploads coverage to Codecov. Coverage upload is set</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L53" href="#L53">53</a><span class="code-text"><a-p>to fail the build on error, so add tests for new behavior and keep existing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L54" href="#L54">54</a><span class="code-text"><a-p>tests passing.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L55" href="#L55">55</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L56" href="#L56">56</a><span class="code-text"><a-p>## </a-p><a-tt>Linting and formatting</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L57" href="#L57">57</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L58" href="#L58">58</a><span class="code-text"><a-p>The project uses `golangci-lint` (v2) with a strict configuration in</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L59" href="#L59">59</a><span class="code-text"><a-p>`.golangci.yml`. Formatting is enforced via `gofmt` and `goimports`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L60" href="#L60">60</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L61" href="#L61">61</a><span class="code-text"><a-p>```</a-p><a-tl>sh</a-tl></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L62" href="#L62">62</a><span class="code-text"><a-p>make lint    # golangci-lint run -c .golangci.yml</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L63" href="#L63">63</a><span class="code-text"><a-p>gofmt -w .   # format</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L64" href="#L64">64</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L65" href="#L65">65</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L66" href="#L66">66</a><span class="code-text"><a-p>Run `make lint` before opening a pull request — the same check runs in CI and</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L67" href="#L67">67</a><span class="code-text"><a-p>must pass.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L68" href="#L68">68</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L69" href="#L69">69</a><span class="code-text"><a-p>## </a-p><a-tt>Commit messages</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L70" href="#L70">70</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L71" href="#L71">71</a><span class="code-text"><a-p>This project follows [Conventional Commits](https://www.conventionalcommits.org/).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L72" href="#L72">72</a><span class="code-text"><a-p>Prefix each commit subject with a type, optionally scoped:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L73" href="#L73">73</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L74" href="#L74">74</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L75" href="#L75">75</a><span class="code-text"><a-p>&lt;type&gt;[optional scope]: &lt;description&gt;</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L76" href="#L76">76</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L77" href="#L77">77</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L78" href="#L78">78</a><span class="code-text"><a-p>Common types used in this repo:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L79" href="#L79">79</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L80" href="#L80">80</a><span class="code-text"><a-p>- `feat:` — a new feature</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L81" href="#L81">81</a><span class="code-text"><a-p>- `fix:` — a bug fix</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L82" href="#L82">82</a><span class="code-text"><a-p>- `perf:` — a performance improvement</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L83" href="#L83">83</a><span class="code-text"><a-p>- `refactor:` — a code change that neither fixes a bug nor adds a feature</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L84" href="#L84">84</a><span class="code-text"><a-p>- `docs:` — documentation only</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L85" href="#L85">85</a><span class="code-text"><a-p>- `test:` — adding or fixing tests</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L86" href="#L86">86</a><span class="code-text"><a-p>- `chore:` — tooling, dependencies, and maintenance (e.g. `chore(deps):`)</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L87" href="#L87">87</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L88" href="#L88">88</a><span class="code-text"><a-p>Examples drawn from the history:</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L89" href="#L89">89</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L90" href="#L90">90</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L91" href="#L91">91</a><span class="code-text"><a-p>feat: stop scanning and keep partial results</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L92" href="#L92">92</a><span class="code-text"><a-p>fix(report): make JSON export respect -t, --depth and --summarize filters</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L93" href="#L93">93</a><span class="code-text"><a-p>perf: concurrent processing in sqlite analyzer</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L94" href="#L94">94</a><span class="code-text"><a-p>chore(deps): bump modernc.org/sqlite from 1.49.1 to 1.51.0</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L95" href="#L95">95</a><span class="code-text"><a-p>```</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L96" href="#L96">96</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L97" href="#L97">97</a><span class="code-text"><a-p>Keep the description in the imperative mood and lower case, with no trailing</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L98" href="#L98">98</a><span class="code-text"><a-p>period.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L99" href="#L99">99</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L100" href="#L100">100</a><span class="code-text"><a-p>## </a-p><a-tt>Pull requests</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L101" href="#L101">101</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L102" href="#L102">102</a><span class="code-text"><a-p>- Branch off `master` and open your pull request against `master`.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L103" href="#L103">103</a><span class="code-text"><a-p>- Pull requests are **squash-merged**, and the final commit subject becomes the</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L104" href="#L104">104</a><span class="code-text"><a-p>  release changelog entry — so make it a clean Conventional Commit. GitHub</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L105" href="#L105">105</a><span class="code-text"><a-p>  appends the PR number automatically (e.g. `feat: add web UI (#617)`).</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L106" href="#L106">106</a><span class="code-text"><a-p>- Make sure `make lint` and the test suite pass locally before requesting</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L107" href="#L107">107</a><span class="code-text"><a-p>  review.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L108" href="#L108">108</a><span class="code-text"><a-p>- Add tests and update documentation (`configuration.md`, `gdu.1.md`, etc.) when</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L109" href="#L109">109</a><span class="code-text"><a-p>  your change affects behavior or flags.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L110" href="#L110">110</a><span class="code-text"><a-p>- Keep the change focused; unrelated refactors belong in separate PRs.</a-p></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L111" href="#L111">111</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L112" href="#L112">112</a><span class="code-text"><a-p>## </a-p><a-tt>Reporting issues</a-tt></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L113" href="#L113">113</a><span class="code-text"></span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L114" href="#L114">114</a><span class="code-text">Use the GitHub issue templates for</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L115" href="#L115">115</a><span class="code-text">[bug reports](.github/ISSUE_TEMPLATE/bug_report.md) and</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L116" href="#L116">116</a><span class="code-text">[feature requests](.github/ISSUE_TEMPLATE/feature_request.md). Include your gdu</span><span class="code-break">
</span></span><span class="code-line"><a class="ln" id="L117" href="#L117">117</a><span class="code-text">version, OS, and reproduction steps for bugs.</span></span></pre></div></div>
</main>
</body>
</html>
