I've been writing documentation since 2012, having started in the field post a B.A in Literary Journalism. I have built documentation and curriculum for server-side and cloud-hosted software solutions, and the content I've published has been viewed by millions of real users over the years.
It is tremendously fun to get my hands into every part of the software stack and experience things as a user. This is the absolute crux of the writer-engineer's skillset and what I believe will keep the profession alive even in light of the AI boom. We know because we have done the thing, and in doing it we can better use the available tooling to build better outputs.
I'm struck that for all the writing I've done over the years, I have done absolutely none for myself, or about myself, or reflecting anything I've thought. This site aims to correct that, among other things.
Part 2 of 3 in the "What you know" series. The topic here is about how our knowledge of our industry (or industries) drives the critical-creative process, something AI can replicate in dangerous and misleading ways.
Part 1 of 3 in a series discussing what we know about and how it still matters in the age of offloading knowing onto AI. Here I focus on what you know about your product feeds and drives quality AI engagement, which ultimately leads to better outputs.
AI has the ability to present itself as deterministic - confidently giving consistent answers to a problem set. The reality is that these are probability machines where outputs vary even with standard inputs. The line between skilled operator and future victim lies in recognizing this and using the tools appropriately.
BraiseDocs is a Proof-of-Concept around docs with out-of-the-box support for RAG pipelines and a process-level MCP for improved development.
I wanted to see what the PostGreSQL docs would look like in a slightly more contemporary rendering. More importantly, I wanted to use BraiseDocs to build a RAG + MCP server to see how it could benefit PGSQL development.