doc: some driver documentation cleanup

Another issue addressing #2137. Eliminating about 140 warnings in `drivers`.