Clark C. Evans avatar Clark C. Evans committed c9d7932

minor tweaks to What is HTSQL? in the introduction

Comments (0)

Files changed (1)

doc/introduction.rst

 What is HTSQL?
 ==============
 
-**HTSQL is a comprehensive navigational query language for relational
-databases.**
+HTSQL is a comprehensive navigational query language for relational
+databases and web service gateway.
 
 HTSQL is a Web Service
 ----------------------
 
    .. sourcecode:: text
 
-      GET /school HTTP/1.1
+      http://demo.htsql.org/school
 
    .. image:: img/show_school.png
       :alt: output of /school query
       :target: http://demo.htsql.org/school
 
-*On the left is a URL, on the right is what a browser would show*
+*On the left is a URL, on the right is what a browser would show.*
 
 HTSQL is a query language for the web.  Queries are URLs that can be
 directly typed into a browser; the output could be returned in a variety
       FROM "ad"."school" AS "school"
       ORDER BY 1 ASC
 
-*On the left is an HTSQL query, on the right is the equivalent SQL*
+*On the left is an HTSQL query, on the right is SQL it is translated to.*
 
 HTSQL wraps your existing existing relational database, transparently
 handling SQL complexities for you.  The current version of HTSQL supports
       LEFT OUTER JOIN (SELECT COUNT(TRUE) AS "count", "department"."school_code" FROM "ad"."department" AS "department" GROUP BY 2) AS "department" ON ("school"."code" = "department"."school_code")
       ORDER BY "school"."code" ASC
 
-*On the left is an HTSQL query, on the right is the equivalent SQL*
+*On the left is an HTSQL query, on the right is SQL it is translated to.*
 
-Besides typical expression algebra and rich set of functions, HTSQL provides 
-sophisicated navigational query mechanism, composable query fragments and an 
-extensive macro inclusion system.  In particular, nested aggregations and 
-projections are easy to understand and use.
+Besides typical expression algebra and function set, HTSQL provides
+sophisicated navigational query mechanism, composable query fragments
+and an extensive macro inclusion system.  In particular, nested
+aggregations and projections are easy to understand and use.
 
 HTSQL is Human Parsable
 -----------------------
 
 .. vsplit::
 
-   .. container::
+   .. sourcecode:: html
 
       Show me schools, and, for each school, 
       its name, campus, number of programs, 
               avg(department.
                   count(course))}
 
-*On the left is a business inquiry, on the right is the HTSQL translation*
+*On the left is a business inquiry, on the right is the HTSQL translation.*
 
 
 HTSQL is first and formost designed for the *accidental programmer* and
Tip: Filter by directory path e.g. /media app.js to search for public/media/app.js.
Tip: Use camelCasing e.g. ProjME to search for ProjectModifiedEvent.java.
Tip: Filter by extension type e.g. /repo .js to search for all .js files in the /repo directory.
Tip: Separate your search with spaces e.g. /ssh pom.xml to search for src/ssh/pom.xml.
Tip: Use ↑ and ↓ arrow keys to navigate and return to view the file.
Tip: You can also navigate files with Ctrl+j (next) and Ctrl+k (previous) and view the file with Ctrl+o.
Tip: You can also navigate files with Alt+j (next) and Alt+k (previous) and view the file with Alt+o.