docs needed to be better. steps towards that https://x.com/thatalexpalmer/status/2015267904288182641?s=46