docs.addEndpoint(Endpoint.Type.READ, getRenderer);
// GET /suggest/subjects/{hint}
Endpoint suggestSubjects = new Endpoint("/suggest/subjects/{seed}", Method.GET, "suggestsubjects");
suggestSubjects.setDescription("Returns suggestions for subjects based on the given seed");
suggestSubjects.addFormat(new Format("xml", null, null));
suggestSubjects.addStatus(ok("suggestions based on the seed are returned"));
suggestSubjects.addStatus(serviceUnavailable("the site is temporarily offline"));
suggestSubjects.addPathParameter(new Parameter("seed", Parameter.Type.String, "The seed on which suggestions are based"));
suggestSubjects.addOptionalParameter(new Parameter("limit", Parameter.Type.String, "The maximum number of suggestions"));
suggestSubjects.addOptionalParameter(new Parameter("highlight", Parameter.Type.String, "The tag name used to highlight matches"));