better docs with full api description