Improve Vespa clients readme
<!-- Copyright Yahoo. Licensed under the terms of the Apache 2.0 license. See LICENSE in the project root. -->
-# vespa_query_dsl
-This lib is used for composing vespa YQL queries
-Reference: https://docs.vespa.ai/en/reference/query-language-reference.html
+# Vespa clients
-# usage
-Please refer to the unit test:
+## Vespa CLI
+The Vespa command-line tool, see the [README](go/README.md).
-https://github.com/vespa-engine/vespa/blob/master/client/src/test/java/ai/vespa/client/dsl/QTest.java
-# todos
+## Vespa FE (fixme: better name and description here)
+This is a work-in-progress javascript app for various use cases.
+
+
+## vespa_query_dsl
+This lib is used for composing Vespa
+[YQL queries](https://docs.vespa.ai/en/reference/query-language-reference.html).
+
+For usage, refer to the [QTest.java](src/test/java/ai/vespa/client/dsl/QTest.java) unit test.
+
+ToDos:
- [ ] support `predicate` (https://docs.vespa.ai/en/predicate-fields.html)
- [ ] support methods for checking positive/negative conditions for specific field
- [X] support order by annotation
