added first draft doc for the db api in md format