Skip to content

The Theappgap Blog

Deep dives into software, hardware, and the ideas reshaping how we build things.

  • Home
  • Features
  • Tutorials
  • Reviews
  • Open Source
  • AI & ML

Month: June 2026

Documentation Is a Sales Pitch. Code Is the Contract.

By Milton Harris on June, 2026. Posted in Uncategorized.

Documentation Is a Sales Pitch. Code Is the Contract. I’ve burned months of my life trusting documentation that lied. Not […]


The Difference Between Code That Works and Code That Communicates

By Milton Harris on June, 2026. Posted in Uncategorized.

Most developers I meet stop at the first milestone: making the code run. The tests pass, the feature ships, and […]


How Technical Debt Is a Metaphor That Has Outlived Its Usefulness

By Milton Harris on June, 2026. Posted in Uncategorized.

Technical debt has been kicking around software engineering since Ward Cunningham first compared it to financial debt back in 1992. […]


Why the Best Code Review Comments Ask Questions Instead of Giving Orders

By Milton Harris on June, 2026. Posted in Uncategorized.

The Code Review Trap: When Precision Becomes Poison I remember a pull request from my early days at a networking […]


The Problem With Thinking That More Features Make a Better Developer Tool

By Milton Harris on June, 2026. Posted in Uncategorized.

I remember the moment I realized my favorite CLI tool had turned against me. The release notes promised faster builds, […]


Recent Posts

  • The Code Snippet That Never Compiled: Putting Documentation Samples in CI
  • Why the Best Documentation Treats the Reader as Stateful, Not Stateless
  • Why the Best Interview Questions Are About Trade-Offs Not Trivia
  • The Problem With Auto-Generated Documentation That Parrots the Source Code
  • The Problem With Thinking That Performance Optimization Is Always Worthwhile

Recent Comments

    Archives

    • October 2026
    • September 2026
    • August 2026
    • July 2026
    • June 2026
    • May 2026
    • April 2026
    • March 2026
    • February 2026
    • June 2025
    • May 2025
    • April 2025
    • July 2021
    • October 2019
    • August 2019
    • July 2019
    • June 2019
    • May 2019
    • April 2019
    • March 2019

    Categories

    • Dating
    • Uncategorized

    Meta

    • Log in
    • Entries feed
    • Comments feed
    • WordPress.org

    /* ===== EBN Redesign: theappgap.com ===== */ /* Direction: Precision & Clarity | Foundation: Neutral (zinc) | Depth: flat-surface */ :root { --ebn-foreground: #18181b; --ebn-secondary: #52525b; --ebn-muted: #a1a1aa; --ebn-faint: #e4e4e7; --ebn-accent: #6366f1; --ebn-accent-hover: #4f46e5; --ebn-bg_canvas: #fafafa; --ebn-bg_surface: #ffffff; --ebn-bg_surface_alt: #f4f4f5; --ebn-border: #d4d4d8; --ebn-border_light: #e4e4e7; --ebn-radius: 8px; --ebn-radius_sm: 4px; --ebn-radius_lg: 12px; --ebn-shadow: 0 1px 3px rgba(24,24,27,0.06); --ebn-shadow_md: 0 4px 16px rgba(24,24,27,0.08); --ebn-font_display: 'SF Mono', 'Fira Code', 'JetBrains Mono', monospace; --ebn-font_body: -apple-system, 'Segoe UI', system-ui, sans-serif; --ebn-font_mono: 'SF Mono', 'Fira Code', monospace; } /* ===== Global Reset ===== */ body { background-color: var(--ebn-bg_canvas); color: var(--ebn-foreground); font-family: var(--ebn-font_body); line-height: 1.7; -webkit-font-smoothing: antialiased; } /* ===== Site Container ===== */ .site, #page, .hfeed, .wrapper { background-color: var(--ebn-bg_surface); border-radius: var(--ebn-radius_lg); box-shadow: var(--ebn-shadow_md); max-width: 960px; margin: 2rem auto; padding: 2rem; overflow: hidden; } /* ===== Typography ===== */ h1, h2, h3, h4, h5, h6, .entry-title, .page-title, .site-title, .widget-title, .comments-title { color: var(--ebn-foreground); font-family: var(--ebn-font_display); font-weight: 700; line-height: 1.25; letter-spacing: -0.01em; } h1, .entry-title { font-size: 2rem; margin-bottom: 0.75rem; } h2 { font-size: 1.5rem; margin-bottom: 0.625rem; } h3 { font-size: 1.25rem; margin-bottom: 0.5rem; } p { margin-bottom: 1.25rem; color: var(--ebn-secondary); } a { color: var(--ebn-accent); text-decoration: none; transition: color 0.2s ease, text-decoration 0.2s ease; } a:hover { color: var(--ebn-accent-hover); text-decoration: underline; } /* ===== Header ===== */ .site-header, #masthead, header { background-color: var(--ebn-bg_surface); border-bottom: 2px solid var(--ebn-border_light); padding: 1.5rem 0; margin-bottom: 2rem; } .site-title a, .site-title { font-family: var(--ebn-font_display); font-size: 1.75rem; font-weight: 700; color: var(--ebn-foreground); } .site-description { color: var(--ebn-muted); font-size: 0.9rem; font-style: italic; } /* ===== Navigation ===== */ .main-navigation, nav.main-navigation { background-color: var(--ebn-bg_surface_alt); border-radius: var(--ebn-radius); padding: 0.5rem 1rem; margin: 1rem 0; } .main-navigation a, nav a { color: var(--ebn-secondary); font-weight: 500; padding: 0.5rem 0.75rem; border-radius: var(--ebn-radius_sm); transition: background-color 0.2s, color 0.2s; } .main-navigation a:hover, nav a:hover { background-color: var(--ebn-faint); color: var(--ebn-accent); } .main-navigation .current_page_item > a { color: var(--ebn-accent); font-weight: 700; } /* ===== Content Area ===== */ .site-content, #content, .hfeed { background-color: var(--ebn-bg_surface); } .entry-content, article .entry-content { font-size: 1.05rem; line-height: 1.8; color: var(--ebn-secondary); } .entry-content p { margin-bottom: 1.25rem; } /* ===== Post Cards ===== */ article.post, article.page, .hentry { background-color: var(--ebn-bg_surface); border: 1px solid var(--ebn-border_light); border-radius: var(--ebn-radius); padding: 1.5rem; margin-bottom: 2rem; box-shadow: var(--ebn-shadow); transition: box-shadow 0.2s ease; } article.post:hover, article.page:hover { box-shadow: var(--ebn-shadow_md); } /* ===== Post Meta ===== */ .entry-meta, .entry-utility, .posted-on, .byline { color: var(--ebn-muted); font-size: 0.85rem; margin-bottom: 0.75rem; } .entry-meta a, .byline a { color: var(--ebn-accent); } /* ===== Read More ===== */ .more-link, .read-more { display: inline-block; margin-top: 1rem; padding: 0.5rem 1.25rem; background-color: var(--ebn-accent); color: #ffffff; border-radius: var(--ebn-radius); font-weight: 600; font-size: 0.9rem; transition: background-color 0.2s ease, transform 0.1s ease; } .more-link:hover, .read-more:hover { background-color: var(--ebn-accent-hover); color: #ffffff; text-decoration: none; transform: translateY(-1px); } /* ===== Sidebar / Widgets ===== */ .widget-area, #secondary, aside { background-color: var(--ebn-bg_surface_alt); border-radius: var(--ebn-radius); padding: 1.5rem; } .widget { background-color: var(--ebn-bg_surface); border: 1px solid var(--ebn-border_light); border-radius: var(--ebn-radius); padding: 1.25rem; margin-bottom: 1.5rem; box-shadow: var(--ebn-shadow); } .widget-title { font-size: 1rem; font-weight: 700; color: var(--ebn-foreground); border-bottom: 2px solid var(--ebn-accent); padding-bottom: 0.5rem; margin-bottom: 1rem; } /* ===== Blockquotes ===== */ blockquote, .wp-block-quote { border-left: 4px solid var(--ebn-accent); background-color: var(--ebn-bg_surface_alt); padding: 1rem 1.5rem; margin: 1.5rem 0; border-radius: 0 var(--ebn-radius_sm) var(--ebn-radius_sm) 0; font-style: italic; color: var(--ebn-secondary); } blockquote p, .wp-block-quote p { margin-bottom: 0; } /* ===== Code Blocks ===== */ code, pre, .wp-block-code { background-color: var(--ebn-bg_surface_alt); border: 1px solid var(--ebn-border_light); border-radius: var(--ebn-radius_sm); font-family: var(--ebn-font_mono); font-size: 0.9rem; } pre { padding: 1rem; overflow-x: auto; } code { padding: 0.15rem 0.4rem; } /* ===== Images ===== */ img, .wp-block-image img { border-radius: var(--ebn-radius); max-width: 100%; height: auto; } .wp-caption, .wp-block-image { margin: 1.5rem 0; } /* ===== Buttons ===== */ button, input[type="submit"], .wp-block-button__link { background-color: var(--ebn-accent); color: #ffffff; border: none; border-radius: var(--ebn-radius_sm); padding: 0.625rem 1.5rem; font-weight: 600; cursor: pointer; transition: background-color 0.2s ease, transform 0.1s ease; } button:hover, input[type="submit"]:hover, .wp-block-button__link:hover { background-color: var(--ebn-accent-hover); transform: translateY(-1px); } /* ===== Forms ===== */ input[type="text"], input[type="email"], input[type="search"], input[type="url"], textarea, select { border: 1px solid var(--ebn-border); border-radius: var(--ebn-radius_sm); padding: 0.5rem 0.75rem; font-family: var(--ebn-font_body); font-size: 0.95rem; background-color: var(--ebn-bg_surface); color: var(--ebn-foreground); transition: border-color 0.2s ease, box-shadow 0.2s ease; } input:focus, textarea:focus, select:focus { border-color: var(--ebn-accent); box-shadow: 0 0 0 3px var(--ebn-faint); outline: none; } /* ===== Footer ===== */ .site-footer, #colophon, footer { background-color: var(--ebn-bg_surface_alt); color: var(--ebn-muted); border-top: 1px solid var(--ebn-border_light); padding: 1.5rem; border-radius: 0 0 var(--ebn-radius_lg) var(--ebn-radius_lg); font-size: 0.85rem; text-align: center; } .site-footer a { color: var(--ebn-secondary); } .site-footer a:hover { color: var(--ebn-accent); } /* ===== Comments ===== */ .comment, .comment-body { background-color: var(--ebn-bg_surface); border: 1px solid var(--ebn-border_light); border-radius: var(--ebn-radius); padding: 1rem 1.25rem; margin-bottom: 1rem; } .comment-author { font-weight: 700; color: var(--ebn-foreground); } .comment-meta { font-size: 0.8rem; color: var(--ebn-muted); } /* ===== Pagination ===== */ .nav-links, .pagination { display: flex; gap: 0.5rem; justify-content: center; margin: 2rem 0; } .nav-links a, .page-numbers { display: inline-block; padding: 0.375rem 0.875rem; border: 1px solid var(--ebn-border); border-radius: var(--ebn-radius_sm); color: var(--ebn-secondary); font-size: 0.9rem; transition: all 0.2s ease; } .nav-links a:hover, .page-numbers:hover, .page-numbers.current { background-color: var(--ebn-accent); color: #ffffff; border-color: var(--ebn-accent); } /* ===== Scrollbar (Webkit) ===== */ ::-webkit-scrollbar { width: 8px; } ::-webkit-scrollbar-track { background: var(--ebn-bg_canvas); } ::-webkit-scrollbar-thumb { background: var(--ebn-border); border-radius: 4px; } ::-webkit-scrollbar-thumb:hover { background: var(--ebn-muted); } /* ===== Selection ===== */ ::selection { background-color: var(--ebn-accent); color: #ffffff; } /* ===== Accessibility ===== */ :focus-visible { outline: 2px solid var(--ebn-accent); outline-offset: 2px; } /* ===== Responsive ===== */ @media (max-width: 768px) { .site, #page { margin: 0; border-radius: 0; padding: 1rem; } h1, .entry-title { font-size: 1.5rem; } .widget-area { margin-top: 2rem; } }