adding attribute examples

[natsuki-engr]

• faq
• common techniques
• cookbook

there could be more example codes...

[DerManoMann]

Good stuff! Could you just please rename the files to something more meaningful? For example server_xx.php

[natsuki-engr]

@DerManoMann
Thanks for checking my PR!
In the faq, the annotation sample is shown as an example of "dummy class".
So I chose the filename "dummy_class_xx.php" - was that not appropriate?

The simplest solution to avoid this issue is to add a 'dummy' class to the docblock

Please let me know if my understanding is incorrect. 🙏

[DerManoMann]

My bad - yes, this is fine.

[Kiina]

The other docs all use as OA, while here it's as OAT. If you imported OpenApi\Attributes\Tag as OAT; I would get where the T is coming from, but here it might be wrong and could lead to confusion?

[DerManoMann]

I do that actually everywhere in the codebase to distinguish annotations from attributes.
Very useful for slow migration where you might use both at the same time.

[Kiina]

Well nvm then, seems like halfway through the user guide it sometimes switches to OAT. Cookbook even has both right after another:

https://zircote.github.io/swagger-php/guide/cookbook.html#mostly-virtual-models

[DerManoMann]

Hmm, people seem to use both, but it would be good to settle on a consistent pattern in the docs, I think.

[natsuki-engr]

should make another PR converting OpenApi\Attributes as OA; to OpenApi\Attributes as OAT; or fix my PR?

[DerManoMann]

Ah, fix the PR. You can add more if you want to, too.