Merge pull request deepset-ai#161 from deepset-ai/update-readme

Improve the setup section of the README with a few notes

README.md

@@ -1,18 +1,16 @@
 ## Development
 
-### Environment Variables
-
-Get a [personal access token from GitHub](https://github.com/settings/tokens/new). The `public_repo` scope is sufficient.
+### Getting Started
 
-Create a `.env.local` file and add your token as an env variable:
+First, install Next.js (if needed):
 
 ```bash
-GITHUB_PERSONAL_ACCESS_TOKEN="youraccesstoken"
+npm install next react react-dom
+# or
+yarn install next 
 ```
 
-### Getting Started
-
-First, run the development server:
+Then, run the development server:
 
 ```bash
 npm run dev
@@ -30,6 +28,16 @@ yarn dev:watch
 
 Open [http:https://localhost:3000](http:https://localhost:3000) with your browser to see the result.
 
+#### Environment Variables
+
+If you have permission issues when starting up, get a [personal access token from GitHub](https://github.com/settings/tokens/new). The `public_repo` scope is sufficient.
+
+Create a `.env.local` file and add your token as an env variable:
+
+```bash
+GITHUB_PERSONAL_ACCESS_TOKEN="youraccesstoken"
+```
+
 ### Required Reading
 
 This project makes heavy use of Next.js's [getStaticProps](https://nextjs.org/docs/basic-features/data-fetching#getstaticprops-static-generation) and [getStaticPaths](https://nextjs.org/docs/basic-features/data-fetching#getstaticpaths-static-generation) functions, to fetch markdown files at build time (locally from the `docs` directory as well as from GitHub using the GitHub API) and generate html pages for each of these files. Before working on the project, it's vital that you understand how these functions work and how they apply to this project. [This example](https://github.com/vercel/next.js/tree/canary/examples/blog-starter-typescript) and [this example](https://github.com/vercel/next.js/tree/canary/examples/with-mdx-remote) may be used as simple demonstrations of these functions to solidify your understanding.