diff --git a/docs/user/add-new-service.md b/docs/user/add-new-service.md
index b4cdef3..6a4056f 100644
--- a/docs/user/add-new-service.md
+++ b/docs/user/add-new-service.md
@@ -83,7 +83,7 @@ verbatim — no `-DEV` suffix is ever added, even in `dev`.
 |  Environment | Service Specific | External |
 |---|---|---|
 |`prod` | `PV("AGEBD-MYSERVICE:MYPVNAME")` read&write      | `PV("AGEOP-SOME-SERVICE:SOME-PVNAME")` read&write  |
-| `dev` | `PV("AGEBD-MYSERVICE-DEV:MYPVNAME")`  read&write | `PV("AGEOP-SOME-SERVICE:SOME-PVNAME")` read&write (not actually restricted, see above) |
+| `dev` | `PV("AGEBD-MYSERVICE-DEV:MYPVNAME")`  read&write | `PV("AGEOP-SOME-SERVICE:SOME-PVNAME")` readonly    |
 
 ### Python 
 
@@ -94,6 +94,3 @@ For python services there are 3 environments. The python environment is set thro
 | `AGEBD_ENV=prod`  | uses `prod` PVs   |
 | `AGEBD_ENV=dev`   | uses `dev` PVs    |
 | `AGEBD_ENV=local` | uses fake/mock python objects as PVs, no access to real PVs |
-
-An unset or misspelled `AGEBD_ENV` silently falls back to `local` (mock PVs) rather than
-raising an error — worth knowing if a service seems to be doing nothing.