Skip to content
Laradoc Website

Sections

What are sections?

Sections, which are also referred to as tags (see Swagger documentation), allow you to group your endpoints by a particular theme or category.

Documentation Sections

In your OpenAPI specifications, sections are defined by the tags array of each operation:

OpenAPI Tags

How are they defined?

Laradoc automatically generates sections for your API documentation using an AI model. This means that the names of your Laravel controllers and your code organization do not impact the sections that are created.

The AI model generates a section name for each endpoint solely based on its URI.

Can I edit them?

No, at the moment, Laradoc does not provide a feature for manually editing the names of the automatically generated sections. If this functionality is important for your documentation, please inform us so we can work on its development.