diff --git a/README.md b/README.md
index 2041765d..35b69a5a 100644
--- a/README.md
+++ b/README.md
@@ -1,47 +1,74 @@
# spotify.github.io
-
+
-Showcase site for hand-picked open-source projects by Spotify. It is built using Jekyll & GitHub Actions with a Node.js script to fetch data from the GitHub GraphQL API adding it to a static YAML file in the repository.
+A showcase site for hand-picked open-source projects by Spotify.
+It is built using [Jekyll](https://jekyllrb.com/) and GitHub Actions, with a Node.js script that fetches data from the GitHub GraphQL API and stores it in a YAML file.
-## Development
+---
+
+## Features
+
+- Automatically updated list of Spotify OSS projects
+- Categorized by programming language
+- Fast static site built with Jekyll
+- Easy to contribute via YAML config
+
+---
+
+## Local Development
+
+### 1. Install Requirements
-**Install Jekyll & bundler gems**
+Install [Jekyll](https://jekyllrb.com/) and [Bundler](https://bundler.io/):
```sh
gem install jekyll bundler
```
-
-**Install yarn**
+Install Yarn:
```sh
npm install --global yarn
```
-**Install dependencies** inside of the project folder
+### 2. Install Dependencies
+
+Run inside the project root:
```sh
-yarn & bundle install
+yarn
+bundle install
```
-**Build & serve**
+### 3. Run the Local Server
```sh
bundle exec jekyll serve
```
-**(Optional) Test & update data**
+Open your browser at [localhost](http://localhost:4000)
-[Create a personal GitHub Access Token](https://github.com/settings/tokens) to fetch & update the repository data locally. As the data is updated automatically using GitHub Actions `_data/projects_generated.yaml` should not be added to Git.
-
-```sh
-GH_TOKEN=YOUR_TOKEN node ./scripts/nightly.js
+## File Structure
+```
+text
+.
+├── [_data/]
+│ ├── [_data/projects.yml] # Hand-picked projects (you can add here!)
+│ └── [_data/projects_generated.yaml] # Auto-generated (DO NOT EDIT)
+├── [scripts/]
+│ └── [scripts/nightly.js] # GitHub API fetcher
+├── [_includes/]
+├── [_layouts/]
+├── [_site/] # Generated site output (ignored)
+├── [assets/]
+├── [index.html]
+└── [README.md]
```
----
This project adheres to the [Open Code of Conduct][code-of-conduct]. By participating, you are expected to honor this code.
[code-of-conduct]: https://github.com/spotify/code-of-conduct/blob/master/code-of-conduct.md
+
diff --git a/_data/projects.yaml b/_data/projects.yaml
index 5c3eef75..e11c4ebb 100644
--- a/_data/projects.yaml
+++ b/_data/projects.yaml
@@ -144,3 +144,4 @@
- url: https://github.com/spotify/cstar
- url: https://github.com/spotify/dockerfile-mode
- url: https://github.com/spotify/foss-root
+ - url: https://github.com/spotify/helios