Add documentation on JIRA datasource

docs/datasources.rst

@@ -63,7 +63,7 @@ Graphite
 
 -  **Options**:
 
-   -  Url (mandatory)
+   -  URL (mandatory)
    -  User
    -  Password
    -  Verify SSL certificate
@@ -270,3 +270,15 @@ Microsoft SQL Server
 
    - ``freetds-dev`` C library
    - ``pymssql`` python package, requires FreeTDS to be installed first
+
+
+JIRA (JQL)
+----------
+
+- **Options**:
+
+    - URL (your JIRA instance url)
+    - Username
+    - Password
+
+For information on how to write JIRA/JQL queries, see :doc:`documentation </usage/jira_querying>`.

docs/usage/jira_querying.rst

@@ -0,0 +1,35 @@
+JIRA (JQL): Querying
+#################
+
+*Simple query, just return issues with no filtering:*
+
+.. code:: json
+
+    {
+    }
+
+*Return only specific fields:*
+
+.. code:: json
+
+    {
+        "fields": "summary,priority"
+    }
+
+*Return only specific fields and filter by priority:*
+
+.. code:: json
+
+    {
+        "fields": "summary,priority",
+        "jql": "priority=medium"
+    }
+
+*Count number of issues with `priority=medium`:*
+
+.. code:: json
+
+    {
+        "queryType": "count",
+        "jql": "priority=medium"
+    }