Writing documentation for AI: best practices

docs.kapa.ai
writing-documentation-for-ai:-best-practices

Retrieval-Augmented Generation (RAG) systems like Kapa rely on your documentation to provide accurate, helpful information. When documentation serves both humans and machines well, it creates a self-reinforcing loop of content quality: clear documentation improves AI answers, and those answers help … Read more

Writing Toy Software Is a Joy

jsbarretto.com

I am a huge fan of Richard Feyman’s famous quote: “What I cannot create, I do not understand” I think it’s brilliant, and it remains true across many fields (if you’re willing to be a little creative with the definition … Read more

The Art of Lisp and Writing

dreamsongs.com
the-art-of-lisp-and-writing

The Art of Lisp & Writing Ignorance more frequently begets confidence than does knowledge. –Charles Darwin Lisp is the language of loveliness. With it a great programmer can make a beautiful, operating thing, a thing organically created and formed through … Read more

Writing into Uninitialized Buffers in Rust

blog.sunfishcode.online

Posted on March 11, 2025 Uninitialized buffers in Rust are a long-standing question, for example: Recently, John Nunley and Alex Saveau came up with an idea for a new approach, using a Buffer trait, which is now in rustix 1.0, … Read more

Writing “/etc/hosts” breaks the Substack editor

scalewithlee.substack.com
writing-“/etc/hosts”-breaks-the-substack-editor

An exploration of web security mechanisms and their unexpected consequences The Mysterious Network Error I was working on a technical post about DNS resolution when I encountered something unexpected. Every time I typed the path to the hosts file (/etc/h*sts … Read more