README: update for recent improvements

Remove outdated bits that claim shoddy SQL support and code
structure--we're much better on those fronts now! Also add a few
paragraphs about the current state of SQL compliance, why it's hard to
say anything detailed about SQL compliance, and what our long-term goals
are.

Author: benesch

README.md

@@ -6,13 +6,17 @@
 [![Coverage Status](https://coveralls.io/repos/github/andygrove/sqlparser-rs/badge.svg?branch=master)](https://coveralls.io/github/andygrove/sqlparser-rs?branch=master)
 [![Gitter Chat](https://badges.gitter.im/sqlparser-rs/community.svg)](https://gitter.im/sqlparser-rs/community?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
 
-The goal of this project is to build a SQL lexer and parser capable of parsing SQL that conforms with the [ANSI SQL:2011](https://jakewheat.github.io/sql-overview/sql-2011-foundation-grammar.html#_5_1_sql_terminal_character) standard but also making it easy to support custom dialects so that this crate can be used as a foundation for vendor-specific parsers.
+The goal of this project is to build a SQL lexer and parser capable of parsing
+SQL that conforms with the [ANSI/ISO SQL standard][sql-standard] while also
+making it easy to support custom dialects so that this crate can be used as a
+foundation for vendor-specific parsers.
 
-This parser is currently being used by the [DataFusion](https://github.com/andygrove/datafusion) query engine and [LocustDB](https://github.com/cswinter/LocustDB).
+This parser is currently being used by the [DataFusion] query engine and
+[LocustDB].
 
 ## Example
 
-The current code is capable of parsing some trivial SELECT and CREATE TABLE statements.
+To parse a simple `SELECT` statement:
 
 ```rust
 let sql = "SELECT a, b, 123, myfunc(b) \
@@ -33,23 +37,61 @@ This outputs
 AST: [Query(Query { ctes: [], body: Select(Select { distinct: false, projection: [UnnamedExpr(Identifier("a")), UnnamedExpr(Identifier("b")), UnnamedExpr(Value(Long(123))), UnnamedExpr(Function(Function { name: ObjectName(["myfunc"]), args: [Identifier("b")], over: None, distinct: false }))], from: [TableWithJoins { relation: Table { name: ObjectName(["table_1"]), alias: None, args: [], with_hints: [] }, joins: [] }], selection: Some(BinaryOp { left: BinaryOp { left: Identifier("a"), op: Gt, right: Identifier("b") }, op: And, right: BinaryOp { left: Identifier("b"), op: Lt, right: Value(Long(100)) } }), group_by: [], having: None }), order_by: [OrderByExpr { expr: Identifier("a"), asc: Some(false) }, OrderByExpr { expr: Identifier("b"), asc: None }], limit: None, offset: None, fetch: None })]
 ```
 
+## SQL compliance
+
+SQL was first standardized in 1987, and revisions of the standard have been
+published regularly since. Most revisions have added significant new features to
+the language, and as a result no database claims to support the full breadth of
+features. This parser currently supports most of the SQL-92 syntax, plus some
+syntax from newer versions that have been explicitly requested, plus some MSSQL-
+and PostgreSQL-specific syntax. Whenever possible, the [online SQL:2011
+grammar][sql-2011-grammar] is used to guide what syntax to accept. (We will
+happily accept changes that conform to the SQL:2016 syntax as well, but that
+edition's grammar is not yet available online.)
+
+Unfortunately, stating anything more specific about compliance is difficult.
+There is no publicly available test suite that can assess compliance
+automatically, and doing so manually would strain the project's limited
+resources. Still, we are interested in eventually supporting the full SQL
+dialect, and pull requests that improve compliance will almost certainly be
+accepted.
+
+If you are assessing whether this project will be suitable for your needs,
+you'll likely need to experimentally verify whether it supports the subset of
+SQL that you need. Please file issues about any unsupported queries that you
+discover. Doing so helps us prioritize support for the portions of the standard
+that are actually used.
+
+### Supporting custom SQL dialects
+
+This is a work in progress, but we have some notes on [writing a custom SQL
+parser](docs/custom_sql_parser.md).
+
 ## Design
 
-This parser is implemented using the [Pratt Parser](https://tdop.github.io/) design, which is a top-down operator-precedence parser.
+This parser is implemented using the [Pratt Parser] design, which is a top-down
+operator-precedence parser.
 
-I am a fan of this design pattern over parser generators for the following reasons:
+We are a fan of this design pattern over parser generators for the following
+reasons:
 
-- Code is simple to write and can be concise and elegant (this is far from true for this current implementation unfortunately, but I hope to fix that using some macros)
+- Code is simple to write and can be concise and elegant
 - Performance is generally better than code generated by parser generators
 - Debugging is much easier with hand-written code
-- It is far easier to extend and make dialect-specific extensions compared to using a parser generator
-
-## Supporting custom SQL dialects
-
-This is a work in progress but I started some notes on [writing a custom SQL parser](docs/custom_sql_parser.md).
+- It is far easier to extend and make dialect-specific extensions
+  compared to using a parser generator
 
 ## Contributing
 
-Contributors are welcome! Please see the [current issues](https://github.com/andygrove/sqlparser-rs/issues) and feel free to file more!
+Contributors are welcome! Please see the [current issues] and feel free to file
+more!
+
+Please run [`cargo fmt`] to ensure the code is properly formatted.
 
-Please run [cargo fmt](https://github.com/rust-lang/rustfmt#on-the-stable-toolchain) to ensure the code is properly formatted.
+[`cargo fmt`]: https://github.com/rust-lang/rustfmt#on-the-stable-toolchain
+[current issues]: https://github.com/andygrove/sqlparser-rs/issues
+[DataFusion]: https://github.com/apache/arrow/tree/master/rust/datafusion
+[LocustDB]: https://github.com/cswinter/LocustDB
+[Pratt Parser]: https://tdop.github.io/
+[sql-2011-grammar]: https://jakewheat.github.io/sql-overview/sql-2011-foundation-grammar.html
+[sql-standard]: https://en.wikipedia.org/wiki/ISO/IEC_9075