Document annotations in "Code files"

[TWiStErRob]

Thoughts? I'm thinking about

• android.annotation.TargetApi https://developer.android.com/reference/android/annotation/TargetApi
• tools:targetApi https://developer.android.com/studio/write/tool-attributes#toolstargetapi
• androidx.annotation.RequiresApi
• androidx.annotation.ChecksSdkIntAtLeast
• androidx.test.filters.SdkSuppress
• Robolectric's Config

and what they do, in what practical cases they might be useful?

[ebelinski]

I think this could be a good idea. Are you thinking of these being in a separate table alongside the other definitions tables? I don't have much familiarity with these annotations myself.

[TWiStErRob]

Yeah, somehow separately, as they're tighly related to API levels. A table at the bottom could be good. I can start the PR and then get some experienced community members to have a look and review/expand. In the end the format could change but the contents will stay the same-ish.