DB1: api documentation, fix readme links