Improve setup instructions (#10)

* fix urls

* improve setup instructions

* change ordered list

Author: martinohanlon

.devcontainer/devcontainer.json

@@ -5,14 +5,17 @@
 	"customizations": {
 		"codespaces": {
 			"openFiles": [
-				"INSTRUCTIONS.adoc",
+				"SETUP.md",
 				".env.example",
 				"llm-vectors-unstructured/test_environment.py"
 				]
 		},
 		"vscode": {
 			"settings": {
-				"python.createEnvironment.trigger": "off"
+				"python.createEnvironment.trigger": "off",
+				"workbench.editorAssociations": {
+					"*.md": "vscode.markdown.preview.editor"
+				}
 			},
 			"extensions": [
 				"ms-python.python",

INSTRUCTIONS.adoc

@@ -1,8 +1,8 @@
 = Introduction to Vector Indexes and Unstructured Data
 
-This repository accompanies the link:graphacademy.neo4j.com/courses/llm-vectors-unstructured[Introduction to Vector Indexes and Unstructured Data^] on link:graphacademy.neo4j.com/courses/genai-workshop[GraphAcademy^].
+This repository accompanies the link:https://graphacademy.neo4j.com/courses/llm-vectors-unstructured/[Introduction to Vector Indexes and Unstructured Data^] on link:https://graphacademy.neo4j.com[GraphAcademy^].
 
-For a complete walkthrough of this repository, link:graphacademy.neo4j.com/courses/llm-vectors-unstructured[enrol now^].
+For a complete walkthrough of this repository, link:https://graphacademy.neo4j.com/courses/llm-vectors-unstructured/[enrol now^].
 
 == Tests
 

README.adoc

@@ -0,0 +1,13 @@
+# Setup
+
+This repository accompanies the [Introduction to Vector Indexes and Unstructured Data course](https://graphacademy.neo4j.com/courses/llm-vectors-unstructured) on [GraphAcademy](https://graphacademy.neo4j.com).
+
+When the devcontainer is created, such as in a GitHub codespace, all the required software and packages will be installed.
+
+Follow the [Setup Instructions in GraphAcademy](https://graphacademy.neo4j.com/courses/llm-vectors-unstructured/3-unstructured-data/0-setup/) to get started.
+
+You will need to:
+
+1. Create a new [`.env`](.env) file and copy the contents of the [`.env.example`](.env.example) file into it
+2. Update the environment values in the [`.env`](.env) file with the values in the [Setup Instructions](https://graphacademy.neo4j.com/courses/genai-workshop/1-knowledge-graphs-vectors/1-getting-started/)
+3. Run the [`llm-vectors-unstructured/test_environment.py`](./llm-vectors-unstructured/test_environment.py) program to check the environment is set up correctly.