4 ms·
> I rarely ever read online documentation. The code is the ground truth This can create problems. Relying on the current behavior instead of a documented contr
by abecedarius 5y ago
> I rarely ever read online documentation. The code is the ground truth
This can create problems. Relying on the current behavior instead of a documented contract makes the code brittler. It's sometimes worth it, but it's not something that makes me go "yeah, this is the way" without mentioning any downside.
- toast0 5y agoRelying on the documented contract when it doesn't match the current behavior makes the application broken.
- MathMonkeyMan 5y agoTrue, but relying on the current behavior when it is only one of many behaviors allowed by the contract prevents the author from changing the implementation, or may make porting the function to other platforms more difficult.
- abecedarius 5y agoAnd you typically find out much sooner. That cost is more obvious.