Finally finished the detailed API docs.

Got started on the Design Rationale.