Extend query documentation

[ThirVondukr]

Extends query documentation, adding examples with using decorator, arguments and strawberry.argument

Description

Types of Changes

• Core
• Bugfix
• New feature
• Enhancement/optimization
• Documentation

Issues Fixed or Closed by This PR

Checklist

• My code follows the code style of this project.
• My change requires a change to the documentation.
• I have updated the documentation accordingly.
• I have read the CONTRIBUTING document.
• I have added tests to cover my changes.
• I have tested the changes and verified that they work and don't break anything (as well as I can manage).

[sourcery-ai]

We have skipped reviewing this pull request. All the files appear to be documentation files, which we're not great at reviewing... yet!

[DoctorJohn]

Thanks for the PR @ThirVondukr, LGTM :)

[NafieAlhilaly]

How about 🤔

Suggested change

	deprecation_reason="isTasty argument is deprecated, "
	"use fruits(taste:SWEET) instead",
	deprecation_reason="isTasty argument is deprecated, use fruits(taste:SWEET) instead",

---

@strawberry.type
class Query:
    @strawberry.field
    def fruits(
        self,
        is_tasty: Annotated[
            bool | None,
            strawberry.argument(
                description="Filters out fruits by whenever they're tasty or not",
                deprecation_reason="isTasty argument is deprecated, "
                "use fruits(taste:SWEET) instead",
            ),
        ] = None,
    ) -> list[str]: ...

---

@strawberry.type
class Query:
    @strawberry.field
    def fruits(
        self,
        is_tasty: Annotated[
            bool | None,
            strawberry.argument(
                description="Filters out fruits by whenever they're tasty or not",
                deprecation_reason="isTasty argument is deprecated, use fruits(taste:SWEET) instead",
            ),
        ] = None,
    ) -> list[str]: ...

[ThirVondukr]

This it a bit too long (101) characters, it's hard to read in git diffs, and black by default recommends 88-80 character limit