doc: devicetree: reorganize a bit

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>