Apply suggestions from code review

Author: toumorokoshi

config/hero.yaml

@@ -21,9 +21,8 @@ shortcuts:
       text: Contribute to the project
   - title: Want to adopt AEPs in your organization?
     description: |
-      AEPs were adapted from [Google's AIP project](https://google.aip.dev/), but also extend it with
-      tooling to easily generate and validate that result in better designed APIs, as well as provide clients to 
-      consume them.
+      AEPs were adapted from [Google's AIP project](https://google.aip.dev/), but also enhanced with improved
+      guidance for APIs, tooling to generate and validate them, and clients to interact with them. The result is better designed and consumable APIs.
     button:
       href: /adopting
       text: Learn more

pages/general/adopting.md

@@ -4,13 +4,13 @@ By adopting the guidelines from the API Enhancement Proposals, you establish a m
 tighter and efficient possibility space. APIs that follow the 
 [AEP guidance](https://aep.dev) from the design stage:
 
-- are more consistent  within and across teams, reducing cognitive load for API consumers
+- are more consistent within and across teams, reducing cognitive load for API consumers
 - reduce arguments  about API design decisions, thanks to the AEP specification, tools, and exemplar design patterns
 
 Having an AEP-compliant API also means benefitting from the AEP ecosystem of tooling, such as:
 
 - Linters and validators to ensure adherence to the AEP design specification [proto]()/[openapi]()
-- A command line tool interface genreator that make it easier to work with APIs ([aepcli](https://github.com/aep-dev/aepcli))
+- A dynamic command line interface generator that make it easier to work with APIs ([aepcli](https://github.com/aep-dev/aepcli))
 - Client-side and server-side code generators ([aepc](https://github.com/aep-dev/aepc))
 - A Terraform provider ([terraform-provider-aep](https://github.com/aep-dev/terraform-provider-aep))
 - ... and more! Please start a [discussion](https://github.com/aep-dev/aep.dev/discussions) if there is something you wish to see, validate, or prioritize.