Just try to explain why I should use it and why it's different or better than alternatives - in terms of some qualities of the results rather than how it's implemented
The technical implementation details are also useful to have, but they're a bit hard to parse into "what is this?"
Thanks for the feedback … rough and precise equally appreciated. Computational semiotics was empirically proven with this repo. I will work hard to make the findings and content more accessible for everyone.
FWIW I'm sympathetic to vibe-coded docs as I'm doing it myself a bit lately, but the agents are bad at it by default because all their context is the how and why of technical decisions made while coding with you
they need specific coaching to get them to try to write for the perspective of a new user