typedb / typedb-docs

TypeDB Documentation
27 stars 72 forks source link

error assigning attributes to an entity in Console #391

Open classbasics opened 4 years ago

classbasics commented 4 years ago

Please replace every line in curly brackets { like this } with appropriate answers, and remove this line.

Description

Adapted the Graql, there was no Console code example so maybe I guessed it incorrectly.

my_keyspace> define person sub entity; {} my_keyspace> commit my_keyspace> define person sub entity, has full-name, has nickname, has gender; Error: UNKNOWN: grakn.core.kb.graql.exception.GraqlSemanticException: nickname doesn't have an 'isa', a 'sub' or an 'id'. Please check server logs for the stack trace. All uncommitted data is cleared my_keyspace>

I think the problem is you cannot assign the attribute 'nickname' to 'person' as 'nickname' has not been defined. The docs do not show that this is required, maybe the docs will tell me later, which doesn't help now.

Location of Content

https://dev.grakn.ai/docs/schema/concepts#entity

Expected Content

{ Please describe what you expected to happen. }

Actual Content

{ Please describe what actually happened. }

Additional information

{ Any additional information, including logs or screenshots if you have any. }

classbasics commented 4 years ago

Note Although, in the example above, we have assigned attributes to the person entity, they are yet to be defined. We soon learn how to define an attribute.

I read this after wasting my time trying the examples. Please put this note first and change two words.

Note Although, in the example below, we will assigned attributes to the person entity, they are yet to be defined. We soon learn how to define an attribute.

Better still, go through defining an attribute, then assign the defined attribute to the entity.

This is not the first time the necessary steps are in the docs after they are needed. It is like expecting to read 'Step 2' before doing 'Step 1'.

classbasics commented 4 years ago

There were lots more of read 'Step 2' before doing 'Step 1' so I didn't try to see if it worked

as I expect it won't work, which is a bad expectation of anyone looking at a product.