- use swagger to auto-generate api docs from json schema - add readme guide with necessary details before making it public