Merge pull request #33 from xataio/docs/get-started

Readme: Get Started section

Author: fabien0102

README.md

@@ -1,23 +1,35 @@
-# Xata VSCode extension
+# [Xata](https://xata.io) [VS Code](https://code.visualstudio.com/) Extension
 
-Manage your xatabase schema without leaving VSCode!
+This extension enables users to work with [Xata](https://xata.io) without leaving Visual Studio Code.
 
-## Features
+## Getting Started
+
+Once the extension is installed it from the [VS Code Marketplace](), it should show up in your Activity Bar like in the image below.
+
+![Setup view for the VSCode Extension](https://github.com/xataio/vscode-extension/raw/main/doc/get-started-view.png)
+
+Clicking on any of the **Get Started** buttons should open your default browser. From there, login to your Xata account, and it will prompt you to create an [API key](https://docs.xata.io/concepts/api-keys). 
 
-### Manage your xatabase
+Once the key is created, there will be a new prompt to return to VS Code and your **Explorer** pane should be populated with your workspaces.
+
+![List of workspaces on Xata VSCode Extension](https://github.com/xataio/vscode-extension/raw/main/doc/workspaces-view.png)
+
+## Features
+Here are some ways you can interact with Xata from our VS Code extension. 
+### Manage Your Databases
 
 Create workspaces, databases, branches and columns directly from the sidebar.
 
 ![create-schema](https://github.com/xataio/vscode-extension/raw/main/doc/create-schema.gif)
 
-### Insert & preview your records
+### Preview & Insert Records
 
-Insert your records with auto-completion / validation and preview them.
+Preview, then insert your records into a database of your choice on Xata with auto-completion and validation.
 
 ![insert-record](https://github.com/xataio/vscode-extension/raw/main/doc/insert-preview-records.gif)
 
-## Requirements
+After successfully inserting the record, you can save the file into your project for easy insertion in the future, or for sharing it with others: if they change the `"$schema"` parameter, the same record can be inserted into another database.
 
-You need to have a xata account & personal access token. https://xata.io/
+---
 
-**Enjoy!**
+Made by 🦋