Rework some section titles and separate the API into its own sub-page in the reference section. This is prep work for adding generated reference material on devicetree bindings. Signed-off-by: Martí Bolívar <marti.bolivar@nordicsemi.no>
