Actually, I think we can leave a normal `def subject` with these comments in place so the docs make sense.  That version of the method will never be called (as we re-define it with your extended hook below) but it will make the docs more clear, I think.

@dchelimsky -- can you think of a better way to handle the doc needs here?