Click any tag below to further narrow down your results
Links
This article explains how precise naming in code cuts down mental overhead and speeds up understanding for both humans and AI. It covers naming functions for call-site readability, using wishful thinking to craft natural-language-like code, leveraging domain types for clearer parameters, adjusting name length by scope, and ditching unhelpful prefixes and generic helpers.
- Clearer names can cut debugging time by nearly 20%, and AI tools benefit similarly from better identifiers
- "Wishful thinking" naming—writing calls as if ideal functions already exist—produces natural, sentence-like code (e.g. notify_all(registered_clients, about=the_new_version))
- Using domain-specific types instead of primitives (e.g. Language preferredRssFeedLanguage instead of int languageId) frees names to convey intent
- Dropping noisy conventions—prefixes like "I", get/set method names, and catch-all classes like Utils—leads to clearer, more precise code
This browser extension strips away ads, navigation, scripts and other clutter to extract the main content of any page and convert it into clean Markdown. It uses Mozilla’s Readability library plus customizable options (images, links, metadata) and offers instant copy or download. It streamlines LLM workflows by providing structured, token-efficient input.
- One-click browser extension converts any webpage to clean Markdown using Mozilla's Readability library, stripping ads, nav, and scripts.
- Markdown output uses far fewer tokens than raw HTML, making pages easier for LLMs to parse and reason over.
- Built with Plasmo, React, Tailwind, and Turndown (HTML-to-Markdown), open-sourced under MIT license.
- Offers extras like a preview tab, toggles for images/links/metadata, document map generation, and one-click copy as an AI prompt.
The article explains how starting sentences or sections with signposting phrases (like “The key point is…” or “First…”) helps readers and listeners know what to focus on. It covers both written and verbal contexts, warns that headers alone aren’t enough, and offers prompts to practice adding clear signposts to your own communication.
- Lead with your main point instead of burying it—say "Here are our quarterly goals: X, Y, and Z" rather than making people wait for it mid-sentence.
- Headers and bullet points aren't real signposting; if the underlying logic is weak, formatting alone won't clarify it—you need explicit verbal cues like "The biggest takeaway is..." woven into the actual prose or speech.
- Practice via three exercises: retrofit signposting into a past memo, diagnose a presentation where the audience got lost, and pre-plan signpost phrases before your next complex meeting.