typedb/typedb-docs

Avoid name conflicts by using unique names for downloadable .tql files

Opened this issue · 1 comments

This issue was migrated from typedb/typedb-studio#260

Problem to Solve

In the https://dev.grakn.ai/docs/general/quickstart doc, schema.gql is too generic, call it friendship-schema.gql, or something more descriptive - maybe grakn-friendship-schema.gpl! They will be downloading more such schemas in the future, from your site and elsewhere, let them not be lost in their download folder.

Question: Feel free to study the content of social-network-schema.gql. <=== which schema is this talking about, please fix this if its a typo?

Current Workaround

Keep track of the .gql files downloaded.

Proposed Solution

Give relevant graql download files representative names.

Additional Information

On the back of the slack channel discussions

[`social-network-schema.tql`](../files/social-network/schema.tql){: target="_blank" download="social-network-schema.tql"}
This solution works fine. I should implement it throughout the docs whenever a single schema file is downloaded.