From 1ce3f3b8125ad35183f5972fd3c88a2ef70cf156 Mon Sep 17 00:00:00 2001
From: Nick Martin <nim@meteor.com>
Date: Thu, 16 Feb 2012 17:50:54 -0800
Subject: [PATCH] Add note in docs re empty objects.

---
 docs/client/api.html | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/docs/client/api.html b/docs/client/api.html
index f511f175906..a242eed407c 100644
--- a/docs/client/api.html
+++ b/docs/client/api.html
@@ -84,6 +84,15 @@ <h2 id="meteor"><span>Meteor</span></h2>
 });
 </pre>
 
+<p>Publish acts on individual attributes of objects. If an object has no
+attributes except <code>_id</code>, it will not be published to the
+client.  Generally, empty object are not very useful so this is not a
+problem.  If you need to create and track an object and assign it
+properties later, create it with a simple property
+eg: <code>collection.insert({exists: true});</code>
+</p>
+
+
 <!------------------------------------------------------------------->
 <!-- Meteor.subscribe -------------------------------------------------->