Skip to content

Commit

Permalink
Update src/content/docs/blog/2024-in-review.md
Browse files Browse the repository at this point in the history
Co-authored-by: Yusuke Tsutsumi <[email protected]>
  • Loading branch information
rambleraptor and toumorokoshi authored Dec 20, 2024
1 parent 1fb4260 commit 8357b82
Showing 1 changed file with 3 additions and 1 deletion.
4 changes: 3 additions & 1 deletion src/content/docs/blog/2024-in-review.md
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,9 @@ To complement our command-line tools, we developed a web-based UI for browsing a

### **Enhanced Linting Capabilities**

A major focus this year was improving our linting capabilities, particularly for OpenAPI specifications. Mike Kistler led the effort to revitalize our OpenAPI linter, implementing rules for key AEPs including AEP-132 (List methods) and AEP-135. The linter helps teams validate their APIs against AEP guidance, catching common issues early in the development process.
A major focus this year was improving our linting capabilities, particularly for OpenAPI specifications. Mike Kistler led the effort to revitalize our [OpenAPI linter](https://github.com/aep-dev/aep-openapi-linter), implementing rules for key AEPs including AEP-132 (List methods) and AEP-135. The linter helps teams validate their APIs against AEP guidance, catching common issues early in the development process.

Significantly progress was also made for our [protobuf linter](https://github.com/aep-dev/api-linter), which is now compliant with all of the updated guidance in aep.dev.

The linter's approach balances pragmatism with standards enforcement \- while some rules are mandatory, others can be selectively adopted based on an organization's needs. This flexibility helps teams gradually adopt AEP practices while maintaining consistent APIs. The project uses Spectral as its foundation, allowing teams to build on an established tooling ecosystem while adding AEP-specific validations.

Expand Down

0 comments on commit 8357b82

Please sign in to comment.