Merge pull request #760 from CitrineInformatics/branch_docs_update

Branch docs update

Author: jspeerless

docs/source/workflows/design_workflows.rst

@@ -146,9 +146,14 @@ For example:
 Branches
 --------
 
-Branches are purely an organizational concept, used to group design workflows under a single name. If you do not wish to interact with them, ignore the ``branch_id`` on a DesignWorkflow, and it will be handled for you.
+Branches are purely an organizational concept, used to group design workflows with similar goals under a single name.
+They are the primary organizational concept of AI assets as displayed in our web UI.
+In the context of the Citrine Python client, they can be thought of as a bucket of design workflows.
+If you do not wish to interact with them in the python client, ignore the ``branch_id`` on a DesignWorkflow, and it will be handled for you.
 
-A branch has a name, along with any number of design workflows. A DesignWorkflow can be created and retrieved, and you can list all design workflows on a branch. You can still list all design workflows on the project as before.
+A branch has a name, along with any number of design workflows.
+A DesignWorkflow can be created and retrieved, and you can list all design workflows on a branch.
+You can still list all design workflows on the project as before.
 
 .. code:: python
 
@@ -183,6 +188,14 @@ A branch has a name, along with any number of design workflows. A DesignWorkflow
 When you're done with a branch, it can be archived, removing it from the results of ``list`` and setting the ``archived`` flag.
 ``list_archived`` lists all archived branches in a project. An archived branch can be restored via its unique ID.
 
+Note that archiving branches is independent of archiving the design workflows contained within it.
+Archiving a branch will hide the entire branch from default displays in the web UI.
+As a result, the design workflows it contained within it will also be hidden.
+Yet archiving th branch will *not* change the archived status of the contained design workflows in the context of design workflow listing methods.
+
+Similarly, archiving a design workflow will result in its executions and relevant assets no longer being displayed within the branch.
+Thus, archiving all the design workflows contained within a branch will result in a hidden branch on the web UI, but the archival status of the branch will not change.
+
 .. code:: python
 
     # Display whether your branch is archived.

src/citrine/__version__.py

@@ -1 +1 @@
-__version__ = '1.32.0'
+__version__ = '1.32.1'