Some explanation for the diagram. API specs. And other notes.