[MKT-1078] Framework Guide: NestJS

openapi/frameworks/laravel.mdx

@@ -1,15 +1,15 @@
 ---
-title: How To Generate a OpenAPI/Swagger Spec for Laravel APIs
-description: "Learn how to create a Swagger/OpenAPI spec for your Laravel API."
+title: How to generate OpenAPI for Laravel APIs
+description: "Generate OpenAPI from Laravel API source code to avoid manual documentation."
 ---
 
 import { Callout, YouTube } from "@/mdx/components";
 
-# How To Generate a OpenAPI for Laravel
+# How to generate OpenAPI for Laravel APIs
 
 <YouTube videoId="dn5U_pidRw0" />
 
-You're investing in your API, and that means finally creating an OpenAPI document that accurately describes your API. With the rise in popularity of API-first design some APIs might have declared their OpenAPI before writing the code, but for many the code-first workflow is still fundamental for older APIs. If you're working with an existing Laravel application, you can generate a complete OpenAPI document directly from the API's source code.
+Investing in an API properly means creating an OpenAPI document that accurately describes the API, for documentation, testing, security scans, governance, and SDK generation. With the rise in popularity of API design-first some APIs might have declared their OpenAPI before writing the code, but for many the code-first workflow is still fundamental for older APIs. If you're working with an existing Laravel application, you can generate a complete OpenAPI document directly from the API's source code.
 
 A few excellent tools have come and gone over the years, but these days [Scribe](https://scribe.knuckles.wtf/laravel) is the go to for generating API documentation form Laravel source code, and it happily exports OpenAPI to be used in a variety of other tools: like Speakeasy.