Following up on file-position locking
Following up on file-position locking
Posted Aug 27, 2023 12:07 UTC (Sun) by NAR (subscriber, #1313)In reply to: Following up on file-position locking by tialaramex
Parent article: Following up on file-position locking
Even documentation right next to the code can go stale. At work I've seen it on more occasions than I can count that e.g. new flags or even new function parameters were not added to the documentation. The best effort I've seen to fix these kind of errors is the Elixir DocTest, where the examples in the documentation are actually executed by the unit test framework, so for example if a new function parameter is added (without a default value), the unit test(!) will catch if the documentation was not upgraded. It's far from 100% and there are code where unit testing is complicated, but it's still useful.