add some plugin details

Author: jchate6

docs/api/plugins.md

@@ -2,13 +2,13 @@ TOM Toolkit Plugins
 -------------------
 
 We aim to keep the TOM as lightweight and flexible as possible, and we 
-recognise that every team has their own science goals and often need 
+recognize that every team has their own science goals and often need 
 different functions.  These often come with added dependencies.  
 
 Rather than require users to support all dependencies from all possible 
 functions, we support a range of optional plugin modules for the Toolkit. 
 These range from adding the ability to interface with additional
-observatories, to providing additional plotting or data analytics functionality.
+observatories and catalogs, to providing additional plotting or data analytics functionality.
 
 ### [tom_hermes](https://github.com/TOMToolkit/tom_hermes)
 
@@ -23,13 +23,13 @@ enables users to query this service and harvest alert information.
 
 ### [tom_antares](https://github.com/TOMToolkit/tom_antares)
 
-The [tom-antares](https://github.com/TOMToolkit/tom_antares) plugin adds support
-for querying the [ANTARES](https://antares.noirlab.edu/) broker for targets of interest.
+This plugin adds support for querying the [ANTARES](https://antares.noirlab.edu/) broker for targets of interest.
 
 ### [tom_app_template](https://github.com/TOMToolkit/tom_app_template)
 
-This repository is designed to provide an example template for TOM users 
-wishing to develop their own TOM app.  
+This repository is designed to provide a starting template for TOM users 
+wishing to develop their own TOM app. This app contains all of the basic workflows, 
+directory structure, testing infrastructure, and instructions you will need to get started.
 
 ### [tom_jpl](https://github.com/TOMToolkit/tom_jpl)
 
@@ -49,8 +49,8 @@ Coverage maps.
 
 ### [tom_registration](https://github.com/TOMToolkit/tom_registration)
 
-The [tom_registration](https://github.com/TOMToolkit/tom_registration) plugin introduces support for two TOM registration
-flows--an open registration, and a registration that requires administrator approval.
+This plugin introduces support for two TOM registration
+workflows--an open registration, and a registration that requires administrator approval.
 
 ### [tom_tns](https://github.com/TOMToolkit/tom_tns)
 
@@ -65,20 +65,22 @@ alerts streams.
 
 ### [tom_demoapp](https://github.com/TOMToolkit/tom_demoapp)
 
-This TOM application is designed to demonstrate how users can develop 
-their own TOM applications and integrate them with their TOM systems. 
+This TOM application is not designed to be installed by users, but instead act 
+as a development and demonstration app for users wishing to integrate their 
+own TOM applications with the base TOM toolkit. The code itself serves as example, 
+while the [wiki](https://github.com/TOMToolkit/tom_demoapp/wiki) gives a menu of existing integration points.
 
-### [tom_nonlocalisedevents](https://github.com/TOMToolkit/tom_nonlocalizedevents)
+### [tom_nonlocalizedevents](https://github.com/TOMToolkit/tom_nonlocalizedevents)
 
-Various events in astrophysics are hard to localise, for example gravitational wave
- or neutrino detections.  This app allows the TOM to recognise that a
+Various events in astrophysics are hard to localize, for example gravitational wave
+ or neutrino detections.  This app allows the TOM to recognize that a
 given event may be associated with a number of candidates, and provides 
 custom views designed to support this workflow.
 
 ### [tom_swift](https://github.com/TOMToolkit/tom_swift)
 
-The Neil Gehrels Swift Observatory is a space telescope offering UV/Visible and 
-X-ray instrumentation and rapid response capabilities.  This plugin 
+The [Neil Gehrels Swift Observatory](https://swift.gsfc.nasa.gov/) is a space telescope offering 
+UV/Visible and X-ray instrumentation and rapid response capabilities.  This plugin 
 enables TOM users to submit requests for Target of Opportunity observations 
 with this spacecraft. 
 
@@ -100,22 +102,11 @@ This module provides the ability to submit observations to the
 state, with little error handling and minimal instrument options, but can successfully submit well-formed observation
 requests.
 
-### [dockertom](https://github.com/TOMToolkit/dockertom)
-
-This repository demonstrates how to package a TOM system in a docker container, 
-which is often required for deployment.  
-
 ### [tom-toolkit_component_lib](https://github.com/TOMToolkit/tom-toolkit-component-lib)
 
 Demonstration of how Javascript front-end components can be integrated with 
 a TOM. 
 
-### [tom_scimma](https://github.com/TOMToolkit/tom_scimma)
-
-This app enables a TOM to subscribe to the Hopskotch alert stream developed 
-by the Scalable Cyberinfrastructure to support Multi‑Messenger Astrophysics 
-([SCiMMA](https://scimma.org/)) project.
-
 ### [tom_dash](https://github.com/TOMToolkit/tom_dash)
 
 This module demonstrates how [Plotly-Dash](https://dash.plotly.com/) components can be added to a 
@@ -128,12 +119,17 @@ TOM module to enable observations to be submitted to the
 
 ### [tom_nonsidereal_airmass](https://github.com/TOMToolkit/tom_nonsidereal_airmass)
 
-The [tom_nonsidereal_airmass](https://github.com/TOMToolkit/tom_nonsidereal_airmass) plugin provides a templatetag
+This plugin provides a templatetag
 that supports plotting for non-sidereal objects. The plugin is fully supported by the TOM Toolkit team; however,
 non-sidereal visibility calculations require the PyEphem library, which is minimally supported while its successor
 is in development. The library used for the TOM Toolkit sidereal visibility, astroplan, does not yet support
 non-sidereal visibility calculations.
 
+### [tom_publications](https://github.com/TOMToolkit/tom_publications)
+
+This application prototyped tools to enable users to output latex-formatted 
+data from their TOM system. 
+
 ### [herokutom](https://github.com/TOMToolkit/herokutom)
 
 This repository demonstrates how a TOM system can be deployed to a public 
@@ -147,11 +143,17 @@ base Toolkit.
 
 ### [tom_alerts_dash](https://github.com/TOMToolkit/tom_alerts_dash)
 
-The [tom_alerts_dash](https://github.com/TOMToolkit/tom_alerts_dash) plugin adds responsive ReactJS views to the
-`tom_alerts` module for supported brokers.  This module has been superceded 
+This plugin adds responsive ReactJS views to the
+`tom_alerts` module for supported brokers.  The `tom_alerts` module has been superseded 
 by tom_dataservices in v3.0.0.  
 
-### [tom_publications](https://github.com/TOMToolkit/tom_publications)
+### [dockertom](https://github.com/TOMToolkit/dockertom)
 
-This application prototyped tools to enable users to output latex-formatted 
-data from their TOM system.  
+This repository demonstrates how to package a TOM system in a docker container, 
+which is often required for deployment.  
+
+### [tom_scimma](https://github.com/TOMToolkit/tom_scimma)
+
+This app enables a TOM to subscribe to the Hopskotch alert stream developed 
+by the Scalable Cyberinfrastructure to support Multi‑Messenger Astrophysics 
+([SCiMMA](https://scimma.org/)) project.

tom_dataservices/dataservices.py

@@ -271,7 +271,7 @@ def to_reduced_datums(self, target, data_results=None, **kwargs):
         of query_reduced_data() to create_reduced_datums_from_query()
         :param target: Target object to associate with the ReducedDatum
         :param data_results: Query results from the DataService storing observation data. This should be a dictionary
-            with each key being a data_type (i.e. Photometry, Spectroscopy, etc.)
+        with each key being a data_type (i.e. Photometry, Spectroscopy, etc.)
         """
         if not data_results:
             raise MissingDataException('No Reduced Data dictionary found.')