-
Notifications
You must be signed in to change notification settings - Fork 1.8k
New issue
Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.
By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.
Already on GitHub? Sign in to your account
Improve docs for AdminServlet
et al
#1905
Improve docs for AdminServlet
et al
#1905
Conversation
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mschechter-bellese Thanks for the awesome contribution! ❤️
docs/source/manual/servlets.rst
Outdated
@@ -14,12 +14,52 @@ HealthCheckServlet | |||
``HealthCheckServlet`` responds to ``GET`` requests by running all the [health checks](#health-checks) | |||
and returning ``501 Not Implemented`` if no health checks are registered, ``200 OK`` if all pass, or | |||
``500 Internal Service Error`` if one or more fail. The results are returned as a human-readable | |||
``text/plain`` entity. | |||
``application/json`` entity. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Maybe we could just write "as a human-readable JSON entity"?
``application/json`` entity. | |
JSON entity. |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Updated - thanks!
docs/source/manual/servlets.rst
Outdated
* ``httpStatusIndicator`` (`Boolean``): Determines whether the HTTP status code is used to | ||
determine whether the application is healthy; if not provided, it defaults to the value from the | ||
initialization parameter |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Could we describe the possible HTTP response codes (200, 500, 501)?
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
They're in the lead paragraph; I split them out for clarity
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
@mschechter-bellese Thanks a lot! ❤️
AdminServlet
et al
You're welcome - glad to help out! I probably should have done this on my previous issue :) Next up is getting these changes integrated into Dropwizard via |
Added documentation for the
AdminServlet
and the other metrics-provided servlets, including the new configuration added as part of #1890.Resolves #1896