Skip to content
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

[#46936] Add documentation for Rails::HealthController #46972

Merged
merged 1 commit into from
Jan 16, 2023
Merged

Conversation

zzak
Copy link
Member

@zzak zzak commented Jan 12, 2023

No description provided.

Copy link
Member

@skipkayhil skipkayhil left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is awesome!

@@ -15,6 +15,7 @@ After reading this guide, you will know:
* How to stream data directly to the user's browser.
* How to filter sensitive parameters, so they do not appear in the application's log.
* How to deal with exceptions that may be raised during request processing.
* About the built-in health check end-point useful for load balancers and uptime monitors.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
* About the built-in health check end-point useful for load balancers and uptime monitors.
* How to use the built-in health check end-point with load balancers and uptime monitors.

Should we keep all of these How to ...?

Copy link
Member Author

@zzak zzak Jan 12, 2023

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I intentionally wanted to break up to how-to-chain 😂 basically if we are going to repeat it, then we can prefix that whole list with something that makes sense.. like:

In this guide you will learn how to:

  • Stream data directly to the user's browser.
  • ...

But that felt out of scope for this PR.

guides/source/action_controller_overview.md Outdated Show resolved Hide resolved
guides/source/action_controller_overview.md Outdated Show resolved Hide resolved
guides/source/action_controller_overview.md Outdated Show resolved Hide resolved
railties/lib/rails/health_controller.rb Outdated Show resolved Hide resolved
@zzak
Copy link
Member Author

zzak commented Jan 12, 2023

Co-authored-by: Hartley McGuire <skipkayhil@gmail.com>
@zzak zzak merged commit 529ae77 into rails:main Jan 16, 2023
@zzak zzak deleted the doc-46936 branch January 16, 2023 02:47
zzak added a commit to zzak/rails that referenced this pull request Jan 29, 2023
This is a follow up to rails#46972 where we realized the long list of "How to"s can be rewritten to focus more on the content.
zzak added a commit to zzak/rails that referenced this pull request Feb 6, 2023
There were some changes from rails#46972 that I forgot to make here as well.

I'm intentionally duplicating this information because it's a new feature and I want users to be able to find it where they are.
Whether they are reading the guides online or the API reference somewhere, like in their editor.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants