Apply suggestions from code review

docs/src/main/asciidoc/dev-ui.adoc

@@ -57,7 +57,7 @@ Extensions can:
 
 These are links that reference other (external from Dev UI) data. This data can be HTML pages, text, or other data.
 
-A good example of this is the SmallRye OpenAPI extension that contains links to the generated `openapi` schema in both JSON and YAML format, and a link to Swagger UI:
+A good example of this is the SmallRye OpenAPI extension that contains links to the generated OpenAPI schema in both JSON and YAML format, and a link to Swagger UI:
 
 image::dev-ui-extension-openapi-v2.png[alt=Dev UI extension card,role="center"]
 
@@ -98,11 +98,11 @@ public CardPageBuildItem pages(NonApplicationRootPathBuildItem nonApplicationRoo
 [NOTE]
 .Note about icons
 
-If you find your icon at https://fontawesome.com/search?o=r&m=free[Font awesome], you can map as follow: Example `<i class="fa-solid fa-house"></i>` will map to `font-awesome-solid:house`, so `fa` becomes `font-awesome` and for the icon name, remove the `fa-`;
+If you find your icon at https://fontawesome.com/search?o=r&m=free[Font awesome], you can map as follow: Example `<i class="fa-solid fa-house"></i>` will map to `font-awesome-solid:house`, so `fa` becomes `font-awesome` and for the icon name, remove the `fa-`.
 
 ==== Embedding external content
 
-By default, even external links will render inside (embedded) in Dev UI. In the case of HTML, the page will be rendered, and any other content will be shown using https://codemirror.net/[code-mirror] to markup the media type. For example, the `openapi` schema document in `yaml` format:
+By default, even external links will render inside (embedded) in Dev UI. In the case of HTML, the page will be rendered, and any other content will be shown using https://codemirror.net/[code-mirror] to markup the media type. For example, the OpenAPI schema document in YAML format:
 
 image::dev-ui-extension-openapi-embed-v2.png[alt=Dev UI embedded page,role="center"]