Opinion to documentation

In my opinion it would be better when you first say ;This method is DEPRECATED; or something else, and not at the bottom of method or something.

Because It's like

Go here.
Reading, reading, reading.
Oh.
There is note. `Deprecated`.
Ugh.... :/ couldn't this not be earlier before I had read all?

Just saying .