Fix and clarify OrWhere caveats in SqlBuilder docs

Author: jnoordsij

Diff for: Dapper.SqlBuilder/Readme.md

@@ -85,10 +85,13 @@ var count = conn.ExecuteScalar<int>(countTemplate.RawSql, countTemplate.Paramete
 Limitations and caveats
 --------
 
-OrWhere use `and` not `or` to concat sql problem
+### Combining the Where and OrWhere methods
 
-[Issue 647](https://github.com/DapperLib/Dapper/issues/647) 
+The OrWhere method currently groups all `and` and `or` clauses by type,
+which may result in possibly unexpected outcomes.
+See also [issue 647](https://github.com/DapperLib/Dapper/issues/647).
 
+For example, when providing the following clauses
 ```csharp
 sql.Where("a = @a1");
 sql.OrWhere("b = @b1");
@@ -97,11 +100,11 @@ sql.OrWhere("b = @b2");
 ```
 
 SqlBuilder will generate sql
-```sql=
-a = @a1 AND b = @b1 AND a = @a2 AND b = @b2
+```sql
+a = @a1 AND a = @a2 AND ( b = @b1 OR b = @b2 )
 ```
 
-not
+and not say
 ```sql
 a = @a1 OR b = @b1 AND a = @a2 OR b = @b2
 ```