typedb/typedb-docs

English to TypeQL: guidelines

Closed this issue · 2 comments

Migrated from typedb/typedb-studio#153

Problem to Solve

TypeQL is a good language but it still can be a bit foreign with a bit of learning curve to non-programmers or programmers turned management personnel. It's easier for us to express what we want in English, hence a translator or a helper module could be beneficial to new and existing clients.

Current Workaround

Using TypeQL and manually translating the English requirements to TypeQL.

Proposed Solution

The translator is a helper and does not have to successful 100% in translating English sentences into TypeQL spec. The least it should do is present a template filling in most if not all of the entities from the English query into its TypeQL equivalent.

If presented via GUI, it can be further enhanced to help map the sentences and components of it into the TypeDB entities and TypeQL language constructs. Two-Way reverse engineering would be an awesome topping on the cake.

Saving a template of such mappings between English queries and TypeDB and then making them available to end-users can improve productivity massively.

Additional Information

@tomassabat tells me mauna.ai is busy working with something similar, although we do not know if they will publish an open source version of this work.

Looking at TypeQL its not far away from English hence the mapping and translations can be done fluently.

Are you sure this needs to be in the docs repo? Seems more like an additional tool (with GUI or not) than a document.

Agreed, closing.