docs: 10% more caveats, 20% more realism