Skip to content

Commit

Permalink
chore: Update README.md (#11)
Browse files Browse the repository at this point in the history
  • Loading branch information
alarv authored May 29, 2024
1 parent 9d4872f commit a1accc4
Showing 1 changed file with 3 additions and 3 deletions.
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -36,13 +36,13 @@ gradle bootRun

In our project, we leverage the OpenAPI Generator to streamline our development process. Here’s how it works:

1. **API Specifications**: All API specifications are defined in the `api-swagger.yaml` file. This file contains the entire API structure and expected behaviors.
1. **API Specifications**: All API specifications are defined in the [openapi.yaml](src/main/resources/openapi.yaml) file. This file contains the entire API structure and expected behaviors.

2. **Automatic Code Generation**: We use the OpenAPI Generator plugin which automatically picks up specifications from the `api-swagger.yaml` file. The plugin generates all the necessary code scaffolding based on these specifications, eliminating the need for manually creating controllers.
2. **Automatic Code Generation**: We use the OpenAPI Generator plugin which automatically picks up specifications from the [openapi.yaml](src/main/resources/openapi.yaml) file. The plugin generates all the necessary code scaffolding based on these specifications, eliminating the need for manually creating controllers.

3. **Implementing Business Logic**: Developers are required to implement the service that interfaces with the generated delegate. This service layer is where the business logic is written, ensuring that it conforms to the API specifications defined in the YAML file.

4. **Consistency and Compliance**: By adopting this workflow, we ensure that our API always remains consistent with the OpenAPI specifications. It also adheres to the standards set by our internal use of the Stoplight Studio editor, which aids in maintaining high standards and compliance throughout the API lifecycle.
4. **Consistency and Compliance**: By adopting this workflow, we ensure that our API always remains consistent with the OpenAPI specifications. It also adheres to the standards set by our internal use of the [Stoplight Studio editor](https://upcintua.stoplight.io/studio/jaqpot?importFiles=true), which aids in maintaining high standards and compliance throughout the API lifecycle.

Using this approach, we keep our API definitions centralized, up-to-date, and aligned with the overall architectural requirements.

Expand Down

0 comments on commit a1accc4

Please sign in to comment.