diff --git a/docs/client/api.html b/docs/client/api.html
index c81d3abfb4..fcd7a5fc60 100644
--- a/docs/client/api.html
+++ b/docs/client/api.html
@@ -16,8 +16,14 @@ on the client, just on the server, or *Anywhere*.
On a server, the function will run as soon as the server process is
finished starting. On a client, the function will run as soon as the DOM
-is ready and any `` templates from your `.html` files have been
-put on the screen.
+is ready.
+
+The `startup` callbacks are called in the same order as the calls to
+`Meteor.Startup` were made.
+
+On a client, `startup` callbacks from smart packages will be called
+first, followed by `` templates from your `.html` files,
+followed by your application code.
// On server startup, if the database is empty, create some initial data.
if (Meteor.isServer) {