typedb-docs
typedb-docs copied to clipboard
QuickStart documentation and code snippets should not assume schema already present
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).
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.