Database documentation as poetry 

Reading the Prisma docs and found this lovely section on data modelling (it's more theory than true product docs - sorely missing when it comes to DB stuff usually!)

It's really well written - I really like it!


Database documentation as poetry 

Love it

"Complicated systems, meanwhile, are merely made up of a lot of individual parts, each acting and being acted upon with the rhythm of a clock or an engine. It's possible to encode histories in and define behaviors for a database, but doing so is a strictly top-down exercise; no seemingly-emergent characteristic of a data model is ever anything more than a deterministic bug. Elements of a data model interact with others, but always the same others in the same ways. And some elements are to representation in a database as a screen door is to a submarine, adding at best only an extra point of mechanical failure."

· · Web · 1 · 0 · 0

Database documentation as praxis 

This, in the docs of a DB library:

"The single most sensitive class of information with the most ramifications, bar none, concerns people. Information about people is necessarily political, and modeling a system in which humans participate both reflects and reinforces the politics of the modeler. Who enters or is entered into the system, in what capacities, with which characteristics assumed important or unimportant, visible to whom: politics, every bit of it. "

Sign in to participate in the conversation

Welcome to thundertoot! A Mastodon Instance for 'straya