https://waylonwalker.com/tags/slashpages/atom.xml 2026-02-11T14:00:00Z All posts with the tag "slashpages" Waylon Walker markata-go https://waylonwalker.com/style/ 2026-02-11T14:00:00Z 2026-02-11T14:00:00Z

drafted by kimi

<blockquote> <p>drafted by kimi</p> </blockquote> <h1 id="style">/style</h1> <p>How I write and build this site. A personal style guide.</p> <h2 id="tone-of-voice">Tone of Voice <a href="#tone-of-voice" class="heading-anchor">#</a></h2> <p><strong>Casually self-deprecating with technical credibility.</strong></p> <p>I write like I’m talking to someone at a conference after-party, not a LinkedIn profile. It’s okay to poke fun at myself and my projects. “Under-funded, over-dreamed, barely documented” is a feature, not a bug.</p> <p><strong>Principles:</strong></p> <ul> <li>Use first person (“I”, “me”, “my”)</li> <li>Keep sentences punchy and direct</li> <li>Include real personal details and hobbies</li> <li>Show technical expertise without taking myself too seriously</li> <li>It’s okay to mention frustrations with mainstream tools</li> </ul> <h2 id="writing-rules">Writing Rules <a href="#writing-rules" class="heading-anchor">#</a></h2> <p><strong>Formatting:</strong></p> <ul> <li>No em-dashes. Use periods or commas instead</li> <li>No emoji</li> <li>80 character hard wrap</li> <li>Double space between sentences</li> <li>Headers should be concise (2-4 words)</li> </ul> <p><strong>Structure:</strong></p> <ul> <li>Put code examples front and center</li> <li>Add brief context or “why this matters” even if just one sentence</li> <li>It’s okay to say “I use this when…” or “This saved me from…”</li> <li>Personal anecdotes add authenticity</li> <li>Technical terms are fine, but explain the “why” behind choices</li> </ul> <p><strong>Content Types:</strong></p> <table> <thead> <tr> <th>Type</th> <th>Tone</th> </tr> </thead> <tbody> <tr> <td>Blog posts</td> <td>Full conversational tone, share opinions openly</td> </tr> <tr> <td>Hot tips / TILs</td> <td>Short, practical, but not robotic</td> </tr> <tr> <td>Glossary entries</td> <td>Stiff, definitional tone is intentional</td> </tr> <tr> <td>Daily notes</td> <td>Casual and quick, stream of consciousness is fine</td> </tr> </tbody> </table> <h2 id="code-style">Code Style <a href="#code-style" class="heading-anchor">#</a></h2> <p><strong>Python:</strong></p> <ul> <li>Use <code>uv</code> for package management</li> <li>Type hints required: <code>from typing import TYPE_CHECKING, List, Optional</code></li> <li>Pydantic models for configuration</li> <li>f-strings over concatenation</li> <li>Proper exception handling</li> </ul> <p><strong>Bash:</strong></p> <ul> <li><code>set -euxo pipefail</code> in scripts</li> <li>Use <code>just</code> for task management</li> </ul> <p><strong>Naming:</strong></p> <ul> <li>Functions: snake_case</li> <li>Classes: PascalCase</li> <li>Python files: snake_case</li> <li>Content files: kebab-case</li> </ul> <h2 id="site-architecture">Site Architecture <a href="#site-architecture" class="heading-anchor">#</a></h2> <p><strong>Stack:</strong></p> <ul> <li>Markata (custom Python static site generator)</li> <li>Tailwind CSS v4+ with pnpm</li> <li>Jinja2 templating</li> <li>Markdown with YAML frontmatter</li> <li>Kubernetes hosting (basement cluster)</li> </ul> <p><strong>Directories:</strong></p> <pre><code>plugins/ Markata extensions scripts/ Utility scripts (Typer CLI) templates/ Jinja2 HTML templates pages/ Markdown content tailwind/ CSS source files static/ Built assets </code></pre> <h2 id="content-philosophy">Content Philosophy <a href="#content-philosophy" class="heading-anchor">#</a></h2> <p><strong>DIY Ethic:</strong></p> <p>I emphasize building and maintaining things myself. This site runs on a Kubernetes cluster in my basement because “I love DevOps” like maintaining your own bare-metal cluster just to host a static site.</p> <p><strong>Authenticity:</strong></p> <p>I create this blog with one person in mind: me. If it helps others, great. But I’m writing to document what I learn and think, not to build an audience or optimize for engagement.</p> <p><strong>Learn in Public:</strong></p> <p>Share failures, unfinished projects, and half-baked ideas. The TIL format works because it captures learning in the moment, not after I’ve mastered something.</p> <h2 id="what-i-avoid">What I Avoid <a href="#what-i-avoid" class="heading-anchor">#</a></h2> <ul> <li><strong>“Just”</strong> - The word skips invisible complexity</li> <li><strong>Pretending to know everything</strong> - I’ll say when I’m confused</li> <li><strong>Overly complex solutions</strong> - Prefer systems I can understand and fix</li> <li><strong>Performance for likes</strong> - Not optimizing for engagement metrics</li> </ul> <h2 id="inspiration">Inspiration <a href="#inspiration" class="heading-anchor">#</a></h2> <p>This style guide draws from:</p> <ul> <li><a href="https://indieweb.org/style-guide" style="--favicon-url: url(&#39;/assets/markata/link-avatars/indieweb.org.ico&#39;);" data-favicon="/assets/markata/link-avatars/indieweb.org.ico" class="has-avatar has-avatar-before">slashpages.net /style</a></li> <li><a href="https://rubenerd.com/the-rubenerd-style-guide/" style="--favicon-url: url(&#39;/assets/markata/link-avatars/rubenerd.com.ico&#39;);" data-favicon="/assets/markata/link-avatars/rubenerd.com.ico" class="has-avatar has-avatar-before">Rubenerd style guide</a></li> <li><a href="https://rknight.me/about/design/" style="--favicon-url: url(&#39;/assets/markata/link-avatars/rknight.me.png&#39;);" data-favicon="/assets/markata/link-avatars/rknight.me.png" class="has-avatar has-avatar-before">Robb Knight’s design style</a></li> <li>Years of reading indie web blogs and knowing what I like</li> </ul> <hr/> <p><em>This is a living document. I break these rules when it feels right.</em></p> Waylon Walker hello@waylonwalker.com https://waylonwalker.com https://waylonwalker.com/interests/ 2026-02-11T14:00:00Z 2026-02-11T14:00:00Z

drafted by kimi

<blockquote> <p>drafted by kimi</p> </blockquote> <h1 id="interests">/interests</h1> <p>Things I’m passionate about and why they excite me.</p> <h2 id="mechanical-keyboards">Mechanical Keyboards <a href="#mechanical-keyboards" class="heading-anchor">#</a></h2> <p>I’ve fallen deep into the custom keyboard rabbit hole. Building keyboards combines electronics, ergonomics, and 3D printing into one satisfying hobby.</p> <p><strong>What I love about it:</strong></p> <ul> <li><strong>Tactile feedback</strong> - Every keystroke has personality</li> <li><strong>Ergonomics</strong> - 40% split layouts changed how I think about typing</li> <li><strong>Customization</strong> - From switches to keycaps to case design</li> <li><strong>DIY culture</strong> - Hand wiring, firmware hacking, designing my own PCBs</li> </ul> <p><strong>Current projects:</strong></p> <ul> <li>Building a split 40% wireless keyboard</li> <li>3D printing custom keycaps</li> <li>Designing the “portajohn” keyboard case</li> </ul> <p><a href="/tags/keyboard">See my keyboard posts</a></p> <h2 id="3d-printing">3D Printing <a href="#3d-printing" class="heading-anchor">#</a></h2> <p>From functional parts to artistic experiments, 3D printing lets me materialize ideas.</p> <p><strong>What I print:</strong></p> <ul> <li><strong>Keyboard components</strong> - Cases, keycaps, plate files</li> <li><strong>Practical tools</strong> - Knife sharpeners, microphone mounts, dovetail experiments</li> <li><strong>Kid projects</strong> - Working with Wyatt on various builds</li> <li><strong>Boxes and organizers</strong> - Custom storage solutions</li> </ul> <p><strong>What fascinates me:</strong></p> <p>The ability to iterate rapidly on physical objects. Print, test, adjust, repeat. It’s software development velocity applied to atoms.</p> <p><a href="/tags/3d-printing">See my 3D printing posts</a></p> <h2 id="gaming-especially-with-family">Gaming (Especially with Family) <a href="#gaming-especially-with-family" class="heading-anchor">#</a></h2> <p>Games aren’t just entertainment. They’re shared experiences, learning opportunities, and sometimes career inspiration.</p> <p><strong>Current favorites:</strong></p> <ul> <li><strong>Don’t Starve Together</strong> - Cooperative survival, resource management lessons</li> <li><strong>Minecraft</strong> - Creative building, redstone logic, modding</li> <li><strong>Stardew Valley</strong> - Low-stakes farming cooperation</li> <li><strong>Hollow Knight</strong> - Challenging platformer, currently attempting keyboard-only run</li> </ul> <p><strong>Why gaming matters:</strong></p> <p>Playing with my kids teaches cooperation, problem-solving, and that failure is just another attempt. Plus it’s fun.</p> <p><a href="/tags/gaming">See my gaming posts</a></p> <h2 id="self-hosting--<a href="/homelab/" class="glossary-term" title="A place to self host applications. For me this is primarily self built web applications, and applications for sharing files with my family. Techno Tim has a...">homelab</a>">Self-Hosting &amp; Homelab <a href="#self-hosting--homelab" class="heading-anchor">#</a></h2> <p>I run a Kubernetes cluster in my basement because I enjoy understanding the systems I depend on.</p> <p><strong>What’s running:</strong></p> <ul> <li>Static sites (this blog)</li> <li>Game servers (Minecraft)</li> <li>CI/CD pipelines</li> <li>Personal services</li> </ul> <p><strong>Why I do it:</strong></p> <ul> <li><strong>Learning</strong> - You don’t really understand networking until you’ve debugged DNS at 2am</li> <li><strong>Ownership</strong> - My data, my rules</li> <li><strong>Simplicity</strong> - One person maintaining their own infra learns what’s actually necessary</li> </ul> <p><a href="/tags/kubernetes">See my homelab posts</a></p> <h2 id="terminal-workflows">Terminal Workflows <a href="#terminal-workflows" class="heading-anchor">#</a></h2> <p>I spend most of my day in a terminal. Optimizing that environment is both practical and oddly satisfying.</p> <p><strong>My setup:</strong></p> <ul> <li>neovim for editing</li> <li>tmux for sessions</li> <li>zsh with custom config (no oh-my-zsh)</li> <li>kitty terminal</li> <li>starship prompt</li> </ul> <p><strong>What I optimize for:</strong></p> <p>Speed. Fast startup times, fast key response, fast feedback loops. The terminal rewards efficiency.</p> <p><a href="/tags/terminal">See my terminal posts</a></p> <h2 id="python">Python <a href="#python" class="heading-anchor">#</a></h2> <p>It’s the language that got me into programming seriously, and it remains my default for almost everything.</p> <p><strong>What I build:</strong></p> <ul> <li><strong>Data pipelines</strong> - Kedro, pandas, data engineering workflows</li> <li><strong>CLI tools</strong> - Typer, click, automation scripts</li> <li><strong>Static site generators</strong> - Markata, my DIY solution</li> <li><strong>Random utilities</strong> - If I can script it, I probably will</li> </ul> <p><strong>Why Python:</strong></p> <p>Readable, batteries included, massive ecosystem, and it gets out of the way when I want to solve problems.</p> <p><a href="/tags/python">See my Python posts</a></p> <h2 id="skating">Skating <a href="#skating" class="heading-anchor">#</a></h2> <p>Physical activity that gets me away from screens.</p> <p><strong>What I do:</strong></p> <p>Casual skating, nothing competitive. Just cruising, enjoying movement, clearing my head.</p> <p><strong>Why it matters:</strong></p> <p>Balance. Too much terminal time needs physical counterweight. Plus it’s fun.</p> <h2 id="data-engineering">Data Engineering <a href="#data-engineering" class="heading-anchor">#</a></h2> <p>My professional focus and ongoing fascination.</p> <p><strong>What interests me:</strong></p> <ul> <li>Building reliable data pipelines</li> <li>Making data accessible and useful</li> <li>The intersection of software engineering and data science</li> <li>Tools that make data work less painful</li> </ul> <p><a href="/tags/data">See my data posts</a></p> <hr/> <p><em>These interests overlap and inform each other. Keyboards led to 3D printing. Gaming led to self-hosting game servers. Everything connects back to building and understanding systems.</em></p> <p><em>Inspired by <a href="https://indieweb.org/interests" style="--favicon-url: url(&#39;/assets/markata/link-avatars/indieweb.org.ico&#39;);" data-favicon="/assets/markata/link-avatars/indieweb.org.ico" class="has-avatar has-avatar-before">slashpages.net /interests</a> and <a href="https://chrisburnell.com/note/slash-interests/" style="--favicon-url: url(&#39;/assets/markata/link-avatars/chrisburnell.com.ico&#39;);" data-favicon="/assets/markata/link-avatars/chrisburnell.com.ico" class="has-avatar has-avatar-before">Chris Burnell’s interests</a></em></p> Waylon Walker hello@waylonwalker.com https://waylonwalker.com