diff --git a/docs/modeling-guide.md b/docs/modeling-guide.md
index 0a9246759e..32eef7f219 100644
--- a/docs/modeling-guide.md
+++ b/docs/modeling-guide.md
@@ -577,6 +577,7 @@ class Foo {
 
 The server side default value if the property is not specified.
 Default values can only be specified on optional properties.
+They appear in the generated documentation and do not affect clients.
 
 ```ts
 class Foo {