RT @mountain_ghosts@twitter.com
I can somewhat see the appeal of literate programming, but actually it's really hard to tell a complete story about code purely looking at its present state; you need to tell a story around its history


@ceejbot I believe strongly in "literate infrastructure design" though. The build/config turnover-to-operations templates I pushed onto my teams had specific sections for narrative descriptions of the system.

"This is the grouping of server types, real or virtual, their common affinities, and any known damage propagation vectors."

"This is the journey of a packet from end-user to DB and back, port by port."

"Here's an order, from user search to cart to checkout to card approval/tax to ERP"

Sign in to participate in the conversation
Life raft.

Ceejbot's mastodon instance. This is an overprovisioned, personally-run instance running on AWS. I welcome friends to create accounts here. I intend to run it as long as people are using it.