I've implemented the changes discussed on todays call.
Couple of noteworthy things:
I decided to just capitalise the first word of the label in most case.
I didn't end up capitalising the label's in the ns/index.json file. Didn't feel quite right doing this for Classes.
I've referenced schema.org's description definition, but happy to use another vocabularly if more appropriate.
I've also changed from comment to description in the index.json file too, i.e. for all our custom Classes. To me is made sense, so that both our instances and Classes use the same property keys.
I've implemented the changes discussed on todays call.
Couple of noteworthy things:
labelin most case.label's in the ns/index.json file. Didn't feel quite right doing this for Classes.descriptiondefinition, but happy to use another vocabularly if more appropriate.commenttodescriptionin the index.json file too, i.e. for all our custom Classes. To me is made sense, so that both our instances and Classes use the same property keys.