Design & implement Datagram public API v1

[mjp0]

Public API is something that can make or break any technical project. I have picked few guiding principles for the design:

• Intuitive and "familiar" to use
• Ask as little as possible
• Do as much as possible

I hope that the above will create an API that doesn't require reading an O'Reilly book to be usable.

---

Deliverables

• Documented API design with arguments and explanations
• Implementation of the designed API

[mjp0]

I've completed the basic outline of the API. It still lacks documented arguments and explanations. I'm going to keep this active but freeze it until I have completed the first implementation. Implementation can many times bring out technical or workflow issues you don't see while designing.