Add data api docs

[Liam-Doodson]

Add docs for the open beta of GraphQL in Aura

[LackOfMorals]

In Foreword

Stay in touch: Use email ([email protected]), our #graphal channel on our Discord Community, or our forums to report issues, suggest improvements, or ask questions.

typo in discord channel. should be

Stay in touch: Use email ([email protected]), our #graphql channel on our Discord Community, or our forums to report issues, suggest improvements, or ask questions.

[LackOfMorals]

Pre-reqs

Rewording of

Management of the beta of GraphQL for Neo4j AuraDB is performed using the Aura CLI command line tool. Future versions will be fully integrated with the Aura Console. The Aura CLI will need to be installed and configured for this purpose.

To

Management of the beta of GraphQL for Neo4j AuraDB is performed using the Aura CLI command line tool which will need to be installed. Future versions of GraphQL for Neo4j AuraDB will be fully integrated with the Aura Console.

[LackOfMorals]

Change Read This Before you Start to Read This Before You Start

[rsill-neo4j]

a note about screenshots - they include @LackOfMorals 's account data. we should probably blur that out or replace it with something generic (John Doe style)

[Liam-Doodson]

a note about screenshots - they include @LackOfMorals 's account data. we should probably blur that out or replace it with something generic (John Doe style)

I don't think there's anything too sensitive there right? It's just email (which @LackOfMorals wants to share in these docs for feedback anyway), instanceId (for a short lived testing instance which is probably already deleted and if not is easy to change) and the tenantId

[rsill-neo4j]

not finished yet, but going file by file (since there are incoming commits)

[rsill-neo4j]

prerequisites section

[rsill-neo4j]

i'd argue that installation is the next step after prerequisites, and move the installation sections to their own file. what do you think?

[Liam-Doodson]

I think the reasoning here is that having the aura-cli installed is a prerequisite. It's not part of the GraphQL for Aura offering and is a standalone tool in the same way that the Aura console is a standalone tool that we're adding to

[rsill-neo4j]

deploy and operate section

[rsill-neo4j]

authentication providers section

[rsill-neo4j]

using your api section

[rsill-neo4j]

a note about screenshots - they include @LackOfMorals 's account data. we should probably blur that out or replace it with something generic (John Doe style)

I don't think there's anything too sensitive there right? It's just email (which @LackOfMorals wants to share in these docs for feedback anyway), instanceId (for a short lived testing instance which is probably already deleted and if not is easy to change) and the tenantId

i double-checked with @AlexicaWright -
our public documentation should expose neither a personal email address nor personal account details, because of the visibility on a public website. would the discord channel and the forum link suffice as feedback channels?

[Liam-Doodson]

a note about screenshots - they include @LackOfMorals 's account data. we should probably blur that out or replace it with something generic (John Doe style)

I don't think there's anything too sensitive there right? It's just email (which @LackOfMorals wants to share in these docs for feedback anyway), instanceId (for a short lived testing instance which is probably already deleted and if not is easy to change) and the tenantId

i double-checked with @AlexicaWright - our public documentation should expose neither a personal email address nor personal account details, because of the visibility on a public website. would the discord channel and the forum link suffice as feedback channels?

Okay, @LackOfMorals just provided blurred images so I've just updated it to use those instead

[neo-technology-commit-status-publisher]

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

[rsill-neo4j]

cropped the images (to not show the browser) and blurred the avatar images

[Liam-Doodson]

Closing in favour of #226