Document annotations in "Code files"

ebelinski / apilevels

A microsite overview of all Android 🤖 versions and their corresponding API/SDK levels, version codes, codenames, and market shares.

https://apilevels.com

MIT License

225 stars 26 forks source link

Document annotations in "Code files" #12

Open TWiStErRob opened 2 years ago

TWiStErRob commented 2 years ago

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 commented 2 years ago

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 commented 2 years ago

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.