diff --git a/src/python/pants/backend/python/targets/python_app.py b/src/python/pants/backend/python/targets/python_app.py
index 5f5a142641b..4643ce2e511 100644
--- a/src/python/pants/backend/python/targets/python_app.py
+++ b/src/python/pants/backend/python/targets/python_app.py
@@ -10,6 +10,16 @@
 
 
 class PythonApp(AppBase):
+  """A deployable Python application.
+
+  Invoking the ``bundle`` goal on one of these targets creates a
+  self-contained artifact suitable for deployment on some other machine.
+  The artifact contains the executable pex, its dependencies, and
+  extra files like config files, startup scripts, etc.
+
+  :API: public
+  """
+
   @classmethod
   def alias(cls):
     return 'python_app'
diff --git a/src/python/pants/build_graph/app_base.py b/src/python/pants/build_graph/app_base.py
index 517246b2e22..30121ab8b88 100644
--- a/src/python/pants/build_graph/app_base.py
+++ b/src/python/pants/build_graph/app_base.py
@@ -212,8 +212,8 @@ def __init__(self,
                archive=None,
                **kwargs):
     """
-    :param string binary: Target spec of the ``jvm_binary`` that contains the
-      app main.
+    :param string binary: Target spec of the ``jvm_binary`` or the ``python_binary``
+      that contains the app main.
     :param bundles: One or more ``bundle``\s
       describing "extra files" that should be included with this app
       (e.g.: config files, startup scripts).