better docs for *_requirements functions

I see `Docs: omit` here, but can we document it better? right now it's a bit obscure...
e.g. there are `tool_requires`, `build_requires`, `test_requires` in addition to regular `requirements`.
I see that they may have an additional arguments (e.g. `transitive_headers` and `force_host_context` are briefly mentioned in [Migrating the recipes](https://docs.conan.io/en/latest/migrating_to_2.0/recipes.html) article).
however, I cannot find a reference for their full signatures anywhere, e.g. what is the list of possible parameters and what are their types?

_Originally posted by @SSE4 in https://github.com/conan-io/conan/issues/12081#issuecomment-1243394334_