Update links and tweak text on Embedded use case page (#990)

* Update links and tweak text on Embedded use case page

* Update _data/new-data/get-started/embedded/card-grid.yml

* Update _data/new-data/get-started/embedded/card-grid.yml

* Update _data/new-data/get-started/embedded/hero.yml

* Apply suggestions from code review

---------

Co-authored-by: Mishal Shah <shahmishal@users.noreply.github.com>

Author: kubamracek

_data/new-data/get-started/embedded/card-grid.yml

@@ -6,12 +6,15 @@ tertiary_cards:
   - name: "Integrate with Raspberry Pi Pico SDK"
     text: "Take advantage of seamless interoperatibility and use existing APIs from the Pico SDK directly from your Swift code."
     link_text: Open guide
-    link: https://swiftpackageindex.com/apple/swift-embedded-examples/main/documentation/embeddedswift/integratewithpico
+    link: https://docs.swift.org/embedded/documentation/embedded/picoguide
   - name: "Go baremetal on STM32 chips"
     text: "For maximum control, you can run completely baremetal and use Swift MMIO to operate hardware devices."
     link_text: Open guide
     link: https://swiftpackageindex.com/apple/swift-embedded-examples/main/documentation/embeddedswift/stm32baremetalguide
-paragraph:
+text:
   Embedded Swift is not limited to specific hardware devices or platforms. It's versatile, it can be integrated with
-  existing SDKs and build systems, and it can also be used for pure baremetal development. Most commonly used ARM
-  and RISC-V chips can be targeted by the Swift toolchain.
+  existing SDKs and build systems, and it can also be used for pure baremetal development. Most common ARM
+  and RISC-V chips can be targeted by the Swift toolchain.
+link:
+  url: https://docs.swift.org/embedded/documentation/embedded/integratingwithplatforms
+  text: Learn more about integration with other platforms and build systems

_data/new-data/get-started/embedded/code-image-column.yml

@@ -24,7 +24,7 @@ code: |-
       }
     } 
   }
-body: In just 788 bytes, Embedded Swift powers Conway’s Game of Life on the Playdate handheld—melding high‑level abstractions with low‑level bit‑twiddling for real‑time animation.
+body: In just 788 bytes of resulting compiled code, Embedded Swift powers Conway’s Game of Life on the Playdate handheld—melding high‑level abstractions with low‑level bit‑twiddling for real‑time animation.
 link:
   url: https://www.swift.org/blog/byte-sized-swift-tiny-games-playdate/
   text: Learn more

_data/new-data/get-started/embedded/hero.yml

@@ -1,12 +1,12 @@
 headline: Create embedded software with Swift
 body: Develop efficient, reliable firmware for devices like microcontrollers
 link:
-  url: /getting-started/embedded-swift
+  url: https://docs.swift.org/embedded/documentation/embedded/waystogetstarted
   text: Get Started
 boxes:
   - title: Safe
     text: Eliminate buffer overruns and null‑pointer crashes at compile time, keeping your firmware dependable and robust.
   - title: Interoperable
     text: Reuse existing C/C++ drivers and SDKs with zero wrappers or runtime glue, integrating in minutes.
   - title: Tiny
-    text: Produce meaningful programs measured in kilobytes that are capable of running on constrained devices with no hidden overhead.
+    text: Produce meaningful programs measured in kilobytes that are capable of running on constrained devices with no hidden overhead.

_data/new-data/get-started/embedded/link-columns.yml

@@ -2,8 +2,10 @@ headline: Learn more
 columns:
   - headline: Documentation
     links:
-      - text: Build an embedded app for a microcontroller
-        url: '/getting-started/embedded-swift/'
+      - text: Embedded Swift documentation
+        url: 'https://docs.swift.org/embedded/documentation/embedded'
+      - text: Getting started with Embedded Swift
+        url: 'https://docs.swift.org/embedded/documentation/embedded/waystogetstarted'
       - text: Embedded Swift vision document
         url: 'https://github.com/swiftlang/swift-evolution/blob/main/visions/embedded-swift.md'
       - text: Embedded Swift example projects
@@ -21,4 +23,4 @@ columns:
       - text: Embedded category on Swift forums
         url: 'https://forums.swift.org/c/development/embedded/107'
       - text: Embedded Swift community hour
-        url: 'https://forums.swift.org/t/embedded-swift-community-hour-may-9-2025/79647/'
+        url: 'https://forums.swift.org/t/embedded-swift-community-hour-may-9-2025/79647/'

_data/new-data/get-started/embedded/primary-content.yml

@@ -20,7 +20,7 @@ secondary_cards:
     logo: /assets/images/get-started/interactive-ui-examples@2x.png
     text: Build projects using the popular embedded graphics library LVGL on an STM32 board for rich UI and touch input.
     link_text: Learn more
-    link: https://github.com/apple/swift-embedded-examples/pull/104
+    link: https://github.com/apple/swift-embedded-examples/tree/main/stm32-lvgl
 
   - name: PlaydateKit
     logo: /assets/images/get-started/playdate-kit@2x.png
@@ -31,4 +31,4 @@ secondary_cards:
 
 link:
   url: https://github.com/apple/swift-embedded-examples
-  text: Explore more Embedded Swift examples and templates on Github
+  text: Explore more Embedded Swift examples and templates on Github

_includes/new-includes/components/card-grid.html

@@ -50,7 +50,11 @@ <h2>{{ include.content.title }}</h2>
       </li>
       {% endfor %}
     </ul>
-    {% endif %} {% if include.content.link %}
+    {% endif %}
+    {% if include.content.text %}
+    <p>{{ include.content.text }}</p>
+    {% endif %}
+    {% if include.content.link %}
     <a href="{{ include.content.link.url }}"
       >{{ include.content.link.text }}
     </a>

get-started/embedded/index.md

@@ -12,7 +12,7 @@ title: Embedded
 <!-- Runs on many embedded platforms -->
 
 <style>
-.hero-card { aspect-ratio: auto; width: auto; }
+.card-grid p { margin-bottom: 20px; }
 </style>
 {% include new-includes/components/card-grid.html content = site.data.new-data.get-started.embedded.card-grid %}