What is the right way to specify operations?

[renja-g]

Hi, in the docs it tells me to do something like this:

#[ApiResource(
    operations: [
        new Get(),
        new GetCollection()
    ]
)]

But when I look into the demo API it looks like this:

#[GetCollection]
#[Post]
#[Get]
#[Put]
#[Patch]
#[Delete]
#[Put(
    uriTemplate: '/books/{id}/generate-cover.{_format}',
    normalizationContext: ['groups' => ['book:read', 'book:cover']],
    output: false,
    messenger: true,
)]

So what is the right way?
Inside the #ApiResource or outside?

[alanpoulain]

You can use both, but the core team prefers the first one (personally I prefer the second one 🙂).

[renja-g]

Ahh ok, Thanks

[soyuka]

We recommend the first one, as the one with attributes under each another was introduced for backward compatibility reasons, especially that at first attributes did not support instantiating classes inside the attribute and calling new Get would not have been possible at that time.