Merge branch 'hotfix/1.16.2'

Author: kathy-t

docs/assets/images/docs/manage-dois.png

@@ -65,7 +65,8 @@ notebooks:
     latestTagAsDefault: <Boolean>
 
     # 'enableAutoDois' is a notebook-wide setting that will affect ALL branches/tags; only set this as needed in a main branch
-    # to control whether DOIs are automatically issued for tags. Implicit default: True, can only be overridden as False
+    # to control whether DOIs are automatically issued for tags. Default: true.
+    # A value of true will enable automatic DOIs.
     # A value of false will disable automatic DOIs, DOIs will only be issued on demand.
     enableAutoDois: <Boolean>
 

docs/assets/images/docs/toggle-auto-doi.png

@@ -34,7 +34,8 @@ service:
   publish:
 
   # 'enableAutoDois' is a service-wide setting that will affect ALL branches/tags; only set this as needed in a main branch
-  # to control whether DOIs are automatically issued for tags. Implicit default: True, can only be overridden as False
+  # to control whether DOIs are automatically issued for tags. Default: true.
+  # A value of true will enable automatic DOIs.
   # A value of false will disable automatic DOIs, DOIs will only be issued on demand.
   enableAutoDois: <Boolean>
 

docs/assets/templates/notebooks/template-big.dockstore.yml

@@ -58,6 +58,12 @@ tools:
     # A value of true will automatically display the latest tag updated as default.
     # A value of false will retain the default version that has been specified via the Dockstore UI.
     latestTagAsDefault: <Boolean>
+
+    # 'enableAutoDois' is a tool-wide setting that will affect ALL branches/tags; only set this as needed in a main branch
+    # to control whether DOIs are automatically issued for tags. Default: true.
+    # A value of true will enable automatic DOIs.
+    # A value of false will disable automatic DOIs, DOIs will only be issued on demand.
+    enableAutoDois: <Boolean>
 
     # The optional filters section allow specifying sets of Git branches and tags to include for the workflow.
     # If no filters are given, all branches and tags are included.

docs/assets/templates/services/template-big.dockstore.yml

@@ -67,7 +67,8 @@ workflows:
     latestTagAsDefault: <Boolean>
 
     # 'enableAutoDois' is a workflow-wide setting that will affect ALL branches/tags; only set this as needed in a main branch
-    # to control whether DOIs are automatically issued for tags. Implicit default: True, can only be overridden as False
+    # to control whether DOIs are automatically issued for tags. Default: true.
+    # A value of true will enable automatic DOIs.
     # A value of false will disable automatic DOIs, DOIs will only be issued on demand.
     enableAutoDois: <Boolean>
 

docs/assets/templates/tools/template-big.dockstore.yml

@@ -36,8 +36,10 @@ When viewing the public page of an entry, the entry's concept DOI and the select
    :alt: Show DOIs
 
 Dockstore only displays one DOI associated with a entry, even if there is more than one DOI, e.g., one generated by GitHub-Zenodo integration, and another generated by Dockstore.
-If this situation arises, you can control which DOI is displayed via your dashboard. Select the entry, then click "Manage DOIs", and you'll get a dialog like this. Select your choice
-and click "Save".
+If this situation arises, you can control which DOI is displayed via your dashboard. 
+
+Select the entry, then click Manage DOIs, and you'll get a dialog like this. 
+Under DOI selection, click the radio button for the DOI you want to display and your DOI selection will update immediately. Click Done to close the dialog.
 
 
 .. figure:: /assets/images/docs/manage-dois.png
@@ -66,9 +68,6 @@ See :doc:`Creating Snapshots & Requesting DOIs </advanced-topics/snapshot-and-do
 Automatic Dockstore DOI Generation
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-.. note::
-    This feature is currently only available on request. Please contact the Dockstore team at `discuss.dockstore.org <https://discuss.dockstore.org/t/opening-helpdesk-tickets/1506>`__ if you want to participate.
-
 Dockstore will automatically mint a DOI for a version that corresponds to a Git tag, if:
 
 * The entry is published on Dockstore
@@ -78,16 +77,24 @@ Dockstore will automatically mint a DOI for a version that corresponds to a Git
 Automatically-generated DOIs:
 
 * Do not require a Zenodo account
-* Are minted in the Zenodo Dockstore community
+* Are minted in the `Zenodo Dockstore community <https://zenodo.org/communities/dockstore>`__
 * Are editable by request to the Dockstore team
 * Will be editable via a Zenodo account in a subsequent Dockstore release
 
-If you wish to override and disable this feature, you can opt-out on a per-workflow basis by adding the following setting to your `.dockstore.yml` files
+If you wish to override and disable this feature, you can opt-out on a per-entry basis.
+
+For GitHub App entries, add the following setting to your .dockstore.yml files. This is an entry-wide setting that will affect ALL branches/tags; only set this as needed in a main branch.
+For more information, view the :doc:`full .dockstore.yml template </assets/templates/template>` for your entry which includes an explanation of this field.
 
 .. code-block:: yaml
 
    enableAutoDois: false
 
+For hosted workflows and workflows that were registered using our :doc:`legacy registration methods </advanced-topics/legacy/workflow-legacy-registration>`, 
+navigate to your workflow and click the Manage DOIs button. The Manage DOIs dialog will open and you can click the Automatic DOI Generation toggle to disable this feature.
+
+.. figure:: /assets/images/docs/toggle-auto-doi.png
+   :alt: Disable automatic DOI generation
 
 One rare case to potentially watch out for: if your workflows are tagged with your ORCID as an author
 you may get a large number of notifications or workflows automatically added to your ORCID profile.