Document auto-publish feature

closes: #8548
https://pulp.plan.io/issues/8548

CHANGES/8548.doc

@@ -0,0 +1 @@
+Documented the auto-publication and auto-distribution feature.

docs/workflows/publish-host.rst

@@ -4,8 +4,8 @@ Publish and Host
 This section assumes that you have a repository with content in it (a repository version). To do
 this, see the :doc:`sync` or :doc:`upload` documentation.
 
-Create a Publication
---------------------
+Create a Publication (manually)
+-------------------------------
 
 .. literalinclude:: ../_scripts/publication.sh
    :language: bash
@@ -38,6 +38,7 @@ Distribution GET Response (after task is complete)::
         "base_url": "localhost:24816/pulp/content/foo",
         "content_guard": null,
         "name": "baz",
+        "repository": null,
         "publication": "/pulp/api/v3/publications/file/file/7d5440f6-202c-4e71-ace2-14c534f6df9e/"
     }
 
@@ -55,3 +56,22 @@ If you created your repository version using the :doc:`upload` workflow:
 
 .. literalinclude:: ../_scripts/download_after_upload.sh
    :language: bash
+
+Automate Publication and Distribution
+-------------------------------------
+
+With a little more initial setup, you can have publications and distributions for your repositories
+updated automatically when new repository versions are created.
+
+.. code-block:: bash
+
+    # This configures the repository to produce new publications when a new version is created
+    pulp file repository update --name $REPO_NAME --autopublish
+
+    # This configures the distribution to be track the latest repository version for a given repository
+    pulp file distribution update --name $DIST_NAME --repository $REPO_NAME
+
+.. warning::
+    Support for automatic publication and distribution is provided as a tech preview in Pulp 3.
+    Functionality may not work or may be incomplete. Also, backwards compatibility when upgrading
+    is not guaranteed.