Merge pull request #18 from soburi/codex/review-last-3-commits-for-documentation-issues

Codex-generated pull request

Author: soburi

documentation/configuration-guide.md

@@ -203,9 +203,9 @@ To correctly configure PWM and ADC, two independent items must be addressed:
 
 This is similar to configuring GPIO:
 
-1) **Derive from nexus connector maps**
+1) **Derive from connector maps**
 
-   Provide connector mappings via the board’s nexus definitions (e.g., `pwm-map` and `io-channel-map`)
+   Provide connector mappings via the board’s connector definitions (e.g., `pwm-map` and `io-channel-map`)
 
     ```dts
     / {
@@ -231,7 +231,7 @@ This is similar to configuring GPIO:
 
 2) **Explicit lists under `/zephyr,user`**
 
-   Set GPIO Pin lists in `/zephyr,user/pwm-pin-gpios` and `/zephyr,user/adc-pin-gpios`,
+   Set GPIO pin lists in `/zephyr,user/pwm-pin-gpios` and `/zephyr,user/adc-pin-gpios`.
 
     ```dts
     / {
@@ -253,7 +253,7 @@ This is similar to configuring GPIO:
 ArduinoCore-Zephyr needs a list of available PWM/ADC channels.
 You can provide it in either of the following ways (**lowest precedence rule first**):
 
-1) **Derive from nexus connector maps**
+1) **Derive from connector maps**
 
    If the board defines `arduino_pwm` with `pwm-map` and/or `arduino_adc` with `io-channel-map`,
    ArduinoCore-Zephyr can derive the channel lists from those maps.
@@ -262,7 +262,7 @@ You can provide it in either of the following ways (**lowest precedence rule fir
 
 2) **Explicit lists under `/zephyr,user`**
 
-   Sets the PWM/ADC channels corresponding to the pins specified by `pwm-pin-gpios` and `adc-pin-gpios`.
+   Set the PWM/ADC channels corresponding to the pins specified by `pwm-pin-gpios` and `adc-pin-gpios`.
    - PWM channels: `/zephyr,user/pwms`
    - ADC channels: `/zephyr,user/io-channels`
 

documentation/configuration-reference.md

@@ -132,7 +132,7 @@ A. Devicetree node: `/zephyr,user`
     ```
 
 
-### Port provisioning
+### Channel provisioning
 
 #### `io-channels`
 - **Location:** `/zephyr,user`
@@ -215,7 +215,8 @@ B. Board devicetree constructs (board-provided defaults)
 - **Precedence:**
   - Lower than `/zephyr,user/adc-pin-gpios` (association)
   - Lower than `/zephyr,user/io-channels` (provisioning)
-- **Notes:** `io-channel-map`: left = connector pin id, right = target ADC controller/channel; ADC still needs per-channel config under the ADC device node.
+- **Notes:**
+  - `io-channel-map`: left = connector pin id, right = target ADC controller/channel.
   - ADC still requires per-channel configuration under the ADC device node,
     regardless of how the channel list is obtained.
 - **Example:**
@@ -376,4 +377,3 @@ B. Board devicetree constructs (board-provided defaults)
 ### PWM pin association source
 - **Primary:** `/zephyr,user/pwm-pin-gpios`
 - **Fallback:** connector `pwm-map` under `arduino_pwm`
-