typedb-docs icon indicating copy to clipboard operation
typedb-docs copied to clipboard

QuickStart documentation and code snippets should not assume schema already present

Open Phillammon opened this issue 5 years ago • 1 comments

Code snippets in this repository are tested with only a running grakn server and defined schema assumed. While this is appropriate for most snippets, for quickstart, the code required to define the schema should probably also be included (and a completely blank server with no schema defined should thus be used for testing).

Phillammon avatar Oct 21 '20 17:10 Phillammon

I agree, particularly since some of the code snippets do not work after going through significant effort to adapt them to the phone_calls keyspace. Mostly this is due to the comma missing before the 'has' keyword. Eventually I assumed the code snippets are probably wrong as there was too much work in testing them, which is mainly for the purpose of self-education and confirmation of a workable product. Computing the sum of less than 200 ages took about 5 seconds, is also a performance issue. Overall I decided that Grakn might work, but I don't currently have the time or expertise to overlook the problems in the learning curve. I accept that I need more patience, but will go back to JanusGraph on ScyllaDB. Maybe Grakn would be useful as a side database for complex queries once it has matured a bit more.

classbasics avatar Nov 17 '20 00:11 classbasics