start documenting the dird public api