Document public hooks in AS::Reloader

[kirs]

This PR moves documentation for AS::Reloader hooks outside of hidden rdoc block.
I think it's important to at least document #to_prepare, as it can be quite useful.

@rafaelfranca

[rails-bot]

r? @pixeltrix

(@rails-bot has picked a reviewer for you, use r? to override)

[rafaelfranca]

I prefer to keep this second line out. It can be useful for a lot of things, so better to no specify.

[rafaelfranca]

Great idea!

[matthewd]

I think these should be documented as methods, not as hooks -- so, phrased in terms of what the method will do when called ("registers a block .." or something)... or at least as a "callback", which is both literally what they are, and how they're referred to elsewhere (see e.g. after_action, after_commit, after_validation for some variety, but also some consistency).

Let's keep the comprehensive enumeration where it is, too, though. (It's hidden because they're described in terms of their implementation, rather than their app-facing purpose. I agree we need app-facing documentation, but I think the internal one is useful too.)

[kirs]

Thanks for feedback! I updated the PR.

[matthewd]

It's a "callback", not a "hook".

[kirs]

Thanks, fixed 👌