Add primary annotations to the documentation

[IgnatBeresnev]

Is your feature request related to a problem? Please describe.

I'm adding springdoc v2 to a new project and I'm having a hard time remembering which annotations to use to document my DTOs and endpoints.

Naturally, I go to the official documentation (springdoc.org), but does not have a section about primary annotations/properties, or in other words there is no "Get started" that goes beyond just adding the dependency.

So I either have to look at the source code of your examples at the very bottom or open one of my other projects that has springdoc v2 and copy the annotations/properties from there.

Describe the solution you'd like

A section in the docs that gives a few basic examples:

• Documenting a controller
• Documenting an endpoint
• Documenting a DTO

It should probably be under the "Getting started" section, right below the dependency block.

Additional context

I've used springdoc v1 and springfox before and a lot, so I know their annotations, but things changed in v2 and I'm still trying to remember it.

[IgnatBeresnev]

Alternatively, since the annotations are coming from Swagger 3 (which is a separate project I guess), there could be a link in "Getting started" that leads someplace else, like this article (couldn't find anything better, but I didn't spend much time looking -- only needed to refresh it in my memory)

[Mattias-Sehlstedt]

From what I can see both the Github as well as the docs provide references to demos/examples that are not "at the bottom". E.g., Github and docs.

The docs also provide a link to other resources.

My understanding is that the project is first and foremost meant to be an out-of-the-box solution for exposing an existing Spring application as an OpenApi specification without any configuration. And that swagger-annotations can be used to then decorate the specification. So the getting started is getting springdoc, and any additional configuration is references later.

Does the demo applications provide the information that you are interested in?