From a7068ea6366dbcd0d5cd334af7cb1c8b4ef9f473 Mon Sep 17 00:00:00 2001
From: Maciej Kasprzyk <kapustka.maciek@gmail.com>
Date: Wed, 30 Oct 2024 21:47:12 +0100
Subject: [PATCH] docs: edit contributing, how to build (#5163)

---
 CONTRIBUTING.markdown | 16 ++++++++--------
 1 file changed, 8 insertions(+), 8 deletions(-)

diff --git a/CONTRIBUTING.markdown b/CONTRIBUTING.markdown
index 7a479404..1987358d 100644
--- a/CONTRIBUTING.markdown
+++ b/CONTRIBUTING.markdown
@@ -90,26 +90,26 @@ addition or not.
 
 ## Building the site locally
 
-Install Ruby, on macOS you can do it by installing [Homebrew](https://brew.sh/) then
+Install Ruby. On macOS this can be done with [Homebrew](https://brew.sh/).
 
 ```sh
 brew install ruby
+# Install Ruby package manager
+gem install bundler
 ```
 
-then
+Then clone two repos, install dependencies and run.
 
 ```sh
-# Install Ruby bundler
-gem install bundler
-
-# Clone the repo for the website
+# Clone website
 git clone https://github.com/adambard/learnxinyminutes-site
-# and clone the repo with all the content (this repo) into it
+# Clone docs (this repo) nested in website
 git clone https://github.com/<YOUR-USERNAME>/learnxinyminutes-docs ./learnxinyminutes-site/source/docs/
 
-# Install the dependencies and run the site
+# Install dependencies
 cd learnxinyminutes-site
 bundle install
 
+# Run
 bundle exec middleman serve
 ```