Open-source software, engineering notes and practical cheatsheets. Zola 2026-10-19T00:00:00+00:00 https://iocast.github.io/atom.xml 2026-10-19T00:00:00+00:00 2026-10-19T00:00:00+00:00 Unknown https://iocast.github.io/blog/hello-open-source/ <p>Large platforms solve broad problems. Small tools often solve one sharp problem exceptionally well.</p> <h2 id="why-focus-matters"><a class="zola-anchor" href="#why-focus-matters" aria-label="Anchor link for: why-focus-matters">Why focus matters</a></h2> <p>That focus makes them easier to understand, adapt and maintain.</p> <h3 id="less-surface-fewer-bugs"><a class="zola-anchor" href="#less-surface-fewer-bugs" aria-label="Anchor link for: less-surface-fewer-bugs">Less surface, fewer bugs</a></h3> <p>Every feature is a promise you have to keep. Fewer promises, fewer broken ones.</p> <h3 id="faster-onboarding"><a class="zola-anchor" href="#faster-onboarding" aria-label="Anchor link for: faster-onboarding">Faster onboarding</a></h3> <p>A contributor can read the whole codebase in an afternoon.</p> <h2 id="design-principles"><a class="zola-anchor" href="#design-principles" aria-label="Anchor link for: design-principles">Design principles</a></h2> <ul> <li>Keep the core workflow obvious.</li> <li>Prefer portable data formats.</li> <li>Document decisions, not only features.</li> <li>Make contribution paths welcoming.</li> </ul> <h2 id="what-comes-next"><a class="zola-anchor" href="#what-comes-next" aria-label="Anchor link for: what-comes-next">What comes next</a></h2> <p>The projects on this site explore that idea across desktop software, task management and developer tooling.</p> 2026-10-19T00:00:00+00:00 2026-10-19T00:00:00+00:00 Unknown https://iocast.github.io/cheatsheets/zola/ <h2 id="commands"><a class="zola-anchor" href="#commands" aria-label="Anchor link for: commands">Commands</a></h2> <pre class="giallo" style="color: #E1E4E8; background-color: #24292E;" ><code data-lang="shellscript"><span class="giallo-l"><span style="color: #B392F0;">zola</span><span style="color: #9ECBFF;"> serve</span><span style="color: #6A737D;"> # local preview with live reload</span></span> <span class="giallo-l"><span style="color: #B392F0;">zola</span><span style="color: #9ECBFF;"> check</span><span style="color: #6A737D;"> # validate internal and external links</span></span> <span class="giallo-l"><span style="color: #B392F0;">zola</span><span style="color: #9ECBFF;"> build</span><span style="color: #6A737D;"> # write the production site to public/</span></span></code></pre><h2 id="new-content"><a class="zola-anchor" href="#new-content" aria-label="Anchor link for: new-content">New content</a></h2> <pre class="giallo" style="color: #E1E4E8; background-color: #24292E;" ><code data-lang="shellscript"><span class="giallo-l"><span style="color: #B392F0;">mkdir</span><span style="color: #79B8FF;"> -p</span><span style="color: #9ECBFF;"> content/blog</span></span> <span class="giallo-l"><span>$EDITOR content/blog/my-post.md</span></span></code></pre> <p>Use <code>draft = true</code> in front matter while an article is not ready to publish.</p>