DB1: api documentation, fix readme links, another try