Regarding the manpage issue I think one of the big problems is that they fail to describe ioctls, sysfs, etc so it becomes very hard to figure out how to figure out how to use the ABI, or even that it exists.
Hence I think it would be better to add more man pages and require them.