clarify that we'll send citations to DataCite #4821

doc/sphinx-guides/source/admin/make-data-count.rst

@@ -36,6 +36,7 @@ The following metrics will be sent for each published dataset:
 
 - Views ("investigations" in COUNTER)
 - Downloads ("requests" in COUNTER)
+- Citations ("relatedIdentifier" based on "Related Dataset")
 
 Retrieving Make Data Count Metrics from the DataCite Hub
 --------------------------------------------------------

src/main/java/edu/harvard/iq/dataverse/api/MakeDataCountApi.java

@@ -10,6 +10,29 @@
 @Path("admin/makeDataCount")
 public class MakeDataCountApi extends AbstractApiBean {
 
+    /**
+     * TODO: For each dataset, send the following:
+     *
+     * - views
+     *
+     * - downloads
+     *
+     * - citations (based on "Related Dataset"). "DataCite already supports
+     * linking to publications in the DOI-related metadata that you submit with
+     * your DOIs using the 'relatedIdentifier' element. See the DataCite
+     * EventData Guide ( https://support.datacite.org/docs/eventdata-guide ).
+     * These publication linkages are parsed and added to the EventData source.
+     * So, the "hub" is used for reporting Investigations and Requests as
+     * counts, whereas every individual citation event is reported in the DOI
+     * metadata." mbjones at
+     * https://github.com/IQSS/dataverse/issues/4821#issuecomment-440740205
+     *
+     * TODO: While we're working on sending citations for related *datasets* to
+     * DataCite we should also strongly consider sending citations for related
+     * *publications* (articles) as well. See
+     * https://github.com/IQSS/dataverse/issues/2917 and
+     * https://github.com/IQSS/dataverse/issues/2778
+     */
     @POST
     @Path("sendToHub")
     public Response sendDataToHub() {