diff mbox series

what-i-wish-id-known.rst: add Git capitalization and grammar tweaks

Message ID 78481dfe-2916-0f38-7994-dd50fd4ee21c@crashcourse.ca
State New
Headers show
Series what-i-wish-id-known.rst: add Git capitalization and grammar tweaks | expand

Commit Message

Robert P. J. Day May 11, 2026, 11:10 a.m. UTC
Tweaks:

  - use proper capitalization for "Git"
  - various grammar adjustments in basic skills list

Signed-off-by: Robert P. J. Day <rpjday@crashcourse.ca>

---

  i'm submitting this as a new patch and not as a "V2" because it's
sufficiently different from the first one.

  also leaving out the "Software Overview" link update.
diff mbox series

Patch

diff --git a/documentation/what-i-wish-id-known.rst b/documentation/what-i-wish-id-known.rst
index bdb9e492e..34fdca122 100644
--- a/documentation/what-i-wish-id-known.rst
+++ b/documentation/what-i-wish-id-known.rst
@@ -22,8 +22,8 @@  known before embarking on their first build with Yocto Project. Feel free to
 contact us with other suggestions.

 #. **Use Git, not the tarball download:**
-   If you use git the software will be automatically updated with bug updates
-   because of how git works. If you download the tarball instead, you will need
+   If you use Git, the software will be automatically updated with bug updates
+   because of how Git works. If you download the tarball instead, you will need
    to be responsible for your own updates.

 #. **Get to know the layer index:**
@@ -166,23 +166,23 @@  contact us with other suggestions.

    * deal with corporate proxies
    * add a package to an image
-   * understand the difference between a recipe and package
-   * build a package by itself and why that's useful
-   * find out what packages are created by a recipe
+   * understand the difference between a recipe and a package
+   * build an individual package and understand why that's useful
+   * identify which packages are created by a recipe
    * find out what files are in a package
    * find out what files are in an image
-   * add an ssh server to an image (enable transferring of files to target)
-   * know the anatomy of a recipe
+   * add an SSH server to an image (to enable transfer of files to target)
+   * understand the anatomy of a recipe
    * know how to create and use layers
    * find recipes (with the :oe_layerindex:`OpenEmbedded Layer index <>`)
-   * understand difference between machine and distro settings
+   * understand the difference between machine and distro settings
    * find and use the right BSP (machine) for your hardware
    * find examples of distro features and know where to set them
-   * understanding the task pipeline and executing individual tasks
+   * understand the task pipeline and executing individual tasks
    * understand devtool and how it simplifies your workflow
    * improve build speeds with shared downloads and shared state cache
    * generate and understand a dependency graph
-   * generate and understand BitBake environment
+   * generate and understand the BitBake environment
    * build an Extensible SDK for applications development

 #. **Depending on what you primary interests are with the Yocto Project, you