adding HTML usage info, documenting API endpoints