Doc: Pacemaker Development: add section for library APIs

This adds detail about individual libraries, and introduces the concept of
public and internal APIs earlier so it can be used later throughout.