> In my opinion we should first document the recommended way. Assuming > libi2c is the recommended way for all uses it is capable of, that means > documenting libi2c first. > > Additionally, before documenting any of them I'd add a preamble similar > to: "The I2C device can be accessed from user space either using the > libi2c library or using low-level C functions directly. libi2c is more > high-level but has limited functionality.". This is so it's clear to the > reader from the beginning that there are two alternative approaches, > whose explanation will follow. This! If we have such a paragraph, then while I still think swapping makes a bit more sense, the order is not so important to me anymore.
Attachment:
signature.asc
Description: PGP signature
