docs: Tweak grammar in my_first_sensors.md
Subjectively attempt to improve readability.
Signed-off-by: Andrew Jeffery <andrew@aj.id.au>
Change-Id: I556b3b62d51baa1b1cd81d145a2c53948a3731bf
diff --git a/docs/my_first_sensors.md b/docs/my_first_sensors.md
index 092808d..44976c7 100644
--- a/docs/my_first_sensors.md
+++ b/docs/my_first_sensors.md
@@ -2,12 +2,12 @@
This document is meant to bring you from nothing to using Entity-Manager with
Dbus-Sensors to populate a plug-in card's sensor values on dbus. Once the sensor
-values are on dbus, they can be read via IPMI or Redfish, and this is beyond
-this guide.
+values are on dbus, they can be read via IPMI or Redfish (doing so is beyond
+the scope of this guide).
-For the sake of this very simple example, let's pretend there is a PCIe card
-that exposes an 24c02 eeprom and a tmp441 sensor. The PCIe slots are behind an
-smbus mux on the motherboard and are in a device-tree such as this:
+For the sake of this example, let's pretend there is a PCIe card that exposes
+an 24c02 eeprom and a tmp441 sensor. The PCIe slots are behind an smbus mux on
+the motherboard and are in a device-tree such as this:
```
aliases {
@@ -53,8 +53,8 @@
```
The first daemon of interest that will run is the FruDevice portion of
-Entity-Manager. The exact layout of a FRU is beyond this guide, but for this
-example the PCIe card's eeprom holds the following information:
+Entity-Manager. The exact layout of a FRU is beyond the scope of this guide,
+but assume the PCIe card's eeprom holds the following information:
```
Product:
@@ -213,8 +213,6 @@
```
~# busctl tree --no-pager Service xyz.openbmc_project.HwmonTempSensor
-
-root@semitruck:~# busctl tree --no-pager xyz.openbmc_project.HwmonTempSensor
`-/xyz
`-/xyz/openbmc_project
`-/xyz/openbmc_project/sensors
@@ -249,5 +247,6 @@
There you are! You now have the two sensors from the two card instances on dbus.
-This can be more complex, for instance if your card has a mux you can add this,
-will trigger FruDevice to scan those new buses for more devices.
+This can be more complex, for instance if your card has a mux you can add it to
+the configuration, which will trigger FruDevice to scan those new buses for
+more devices.