Allow rendering tags on methods without any docs

[Blacksmoke16]

Fixes #7895.

• Only skip generating docs if the method does not have any docs and doesn't have Deprecated annotation
• Adds specs for generating summary/docs for a method
• Fixes some type links on Int Deprecated messages, so that they are linkable in the API docs

[bcardiff]

Maybe #summary(context, string) could return nil when there is no summary to emit.
If the same is done with #doc(context, string), then the return if !doc && !obj.annotations(@program.deprecated_annotation checks can go away.

WDYT? (But is good for approving on my behalf)

[Blacksmoke16]

@bcardiff Not sure I follow. Isn't that what it's doing already? If there are no docs nor annotations on the method, it'll return early. Otherwise if there is one or the other, there are docs to generate.

EDIT: I suppose we could redo some of the logic to skip the doc block specific stuff if it there are none, and just handle adding the deprecated flag. However I'm not sure if it would be worth it.

[bcardiff]

I meant that the new return if !doc && !obj.annotations(@program.deprecated_annotation) seems odd. If the summary and doc methods returned nil in those cases, then the check is not needed.

It's just an idea for (maybe) cleaner code.

But as I said. Is good for approving. If the refactor make sense to you feel free to iterate.

Thanks!

[sdogruyol]

Thank you @Blacksmoke16 🙏