I find documenting code is tricky business in general, especially when it comes to keeping docs up to date. Sometimes code documentation starts with best intentions, then people forget to update the docs to keep it in line with what the code is doing. At that point you end up with misleading docs which is frankly worse than no docs at all.