I have on multiple occasions written an entire manual for a piece of hardware as I reverse engineered it in trying to use it. The problems go beyond incorrect and flatly missing information, because there is also information that just isn't clear. There's a certain satisfaction in setting the world right by doing the job the hardware supplier failed to do.
But I don't see much value in agitating for device driver writers to do this work. The same reasons that drive a device maker not to provide adequate documentation also drive the driver writers.
Our salvation may be that the drivers, unlike the data sheets, are open source, so the next frustrated user might correct the problem.
Copyright © 2017, Eklektix, Inc.
Comments and public postings are copyrighted by their creators.
Linux is a registered trademark of Linus Torvalds