Merge branch 'master' into v2.0.0

Author: Amrutha Elamparuthy

GCIS Conventions v1.0.pdf

@@ -0,0 +1,20 @@
+
+# Custom Query
+      The custom query tool is an intuitive search functionality that provides a GCIS user with the means to develop simple search queries with downloadable results in the form of a data table. It uses an SQL-type syntax with limited scope: the tool is built around the SQL SELECT, FROM, and WHERE statements, with allowance to specify a wide range of GCIS resource attributes. However, rather than type query statements, a user develops a query by selecting options from drop-down menus.  
+
+      The custom query tool advances search functionality that goes beyond the limitations of the “search bar” in the GCIS website. Importantly, it helps a user develop a query in a stepwise fashion. Also, given the several and sometimes unique attributes belonging to each GCIS publication, the custom query tool simplifies querying by displaying only those attributes relevant to the GCIS publication specified in the first drop down menu. These features are described below.
+
+## Usage
+
+**Step 1** : To develop a query, first start by specifying the initial publication (for example, “Reports”). Like all other input specifications, this can be done by selecting the relevant data table from the drop-down menu.
+
+**Step 2** : Specify one or more attributes (for example, “identifier”) of the selected table to filter by. Only attributes relevant to the publication selected in Step 1 will be displayed. 
+
+**Step 3** : Select a relationship option for the selected publication (for example, “having”).
+
+**Step 4** : Select a secondary publication to query against (for example, “images”).
+
+**Step 5** : Specify attributes for the WHERE statement in similar fashion as described above. 
+
+
+      The above query would read “SELECT Title FROM Report HAVING Image”.

GCIS.2.0.ERD.pdf

@@ -10,6 +10,7 @@ Activities are created to connect components of USGCRP reports to the source pub
 
 Activities are not created for  non-USGCRP products.
 
+
 ## Field Conventions:
 
 | Field | Description |
@@ -34,7 +35,8 @@ Activities are not created for  non-USGCRP products.
 |**spatial_extent**  |Spatial bounds used to restrict the input object. GeoJSON. Optional, depending on applicability.|
 |**data_usage**  |**DEPRECATED**.  A description of the way in which input data were used for this activity.|
 |**notes** |**DEPRECATED**.  Other information about this activity which might be useful for traceability or reproducability.|
-|**duration**  |**DEPRECATED**.  Use activity_duration to document the time taken to perform the activity.
+|**duration**  |**DEPRECATED**.  Use activity_duration to document the time taken to perform the activity. |
+
 
 
 ## Provenance Conventions: