diff --git a/docs/dev/tools/common-errors.md b/docs/dev/tools/common-errors.md
index 42f0d32a6c..408ad8b4df 100644
--- a/docs/dev/tools/common-errors.md
+++ b/docs/dev/tools/common-errors.md
@@ -213,7 +213,15 @@ resource build error: unknown resource type: API "rdk:component:camera" with mod
 1. Check the logs for other errors.
    It may be that the instantiation of the model is failing, for other reasons such as the hardware being disconnected.
 
-### Could not connect to machine part
+### Could not connect to machine part (context deadline exceeded)
+
+**Full Error:** `Error: Could not connect to machine part: context deadline exceeded; context deadline exceeded; mDNS query failed to find a candidate`
+
+**Description:** This error can occur connecting to a machine with the shell service indicating network issues.
+
+**Solution:** See [Network Troubleshooting](/dev/tools/common-errors/#network-troubleshooting) section.
+
+### Could not connect to machine part (ResourceExhausted)
 
 **Full Error:** `Could not connect to machine part: error updating resources: rpc error: code = ResourceExhausted desc = exceeded request limit 100 on resource viam.robot.v1.RobotService`