Documenting technical communication practices, focusing on user experience, and sharing the simple joys of life.
Latest Posts
See More
Building a Local AI Content Review System: From a Small Model to a Web Tool Your Team Will Actually Use
A practical walkthrough of how I built a local AI proofreading system for technical content — covering the rule engine, small-model selection, structure protection, the web UI, and the feedback loop that keeps it learning.
How I Review Technical Docs with AI: From Lightweight Local Checks to Codex Code Review
How I built a layered AI review workflow for technical docs using lightweight local checks, Codex Local, Codex Cloud, and AGENTS.md to catch the issues humans miss most often.
Everyday Information Design Traps That Sneak Up on You – Have You Been Caught Out?
Three real-world examples from Apple’s website, high-speed rail displays, and a commercial sign reveal common information design pitfalls. I break down why they confuse people and share simple, principle-based fixes that dramatically improve clarity and user experience.
Preface: Why I Finally Decided to Build My Own Blog
Hello, I'm Walter Gui, a technical writer. Welcome to my blog, Flowing Docs.
Project Showcase
See More
What I Do
Engineering Technical Documentation
I turn technical complexity into clarity. Through API design, developer experience optimization, and Docs-as-Code workflows, I help teams ship documentation that actually gets used—not just written.
AI-Powered Technical Writing
AI isn't replacing technical writers—it's supercharging them. I experiment with intelligent content generation, automated quality checks, and smart documentation systems that help teams create better content faster.
User-Centric Information Experience
Documentation isn't just about explaining features—it's about guiding humans through their entire journey. I design content that meets users where they are, whether they're skimming for quick answers or diving deep into complex implementations.