Merge 45e81fb26e into d19c7b0a00

CONTRIBUTING.markdown

@@ -90,27 +90,26 @@ addition or not.
 
 ## Building the site locally
 
-You can build the site locally to test your changes. Follow the steps below.
+Install Ruby, on macOS you can do it by installing [Homebrew](https://brew.sh/) then
 
-* Install Ruby language runtime and RubyGems. See
-  [here](https://middlemanapp.com/basics/install/)
-  for more details.
-* Clone or zip download the
-  [learnxinyminutes-site](https://github.com/adambard/learnxinyminutes-site)
-  repository.
-   * `git clone https://github.com/adambard/learnxinyminutes-site`
-* Install Middleman and other required dependencies using Bundler.
-   * `cd learnxinyminutes-site/`
-   * `bundle install`
-* Get the source in place
-   * Copy the contents of your clone of the fork of learnxinyminutes-docs repo
-     into the `source/docs` folder. There shouldn't be a `learnxinyminutes-docs`
-     folder inside the `docs` folder, it should just contain all the repo
-     contents.
-   * Checkout your fork of the learnxinyminutes-docs repo as `source/docs`.
-      * `cd source/docs/`
-      * `git clone https://github.com/YOUR-USERNAME/learnxinyminutes-docs ./source/docs/`
-* Build the site or run a development server to test your changes (NOTE: run
-  these commands at `learnxinyminutes-site/`).
-   * Build - `bundle exec middleman build`
-   * Dev server - `bundle exec middleman --force-polling --verbose`
+```sh
+brew install ruby
+```
+
+then
+
+```sh
+# Install Ruby bundler
+gem install bundler
+
+# Clone the repo for the website
+git clone https://github.com/adambard/learnxinyminutes-site
+# and clone the repo with all the content (this repo) into it
+git clone https://github.com/<YOUR-USERNAME>/learnxinyminutes-docs ./learnxinyminutes-site/source/docs/
+
+# Install the dependencies and run the site
+cd learnxinyminutes-site
+bundle install
+
+bundle exec middleman serve
+```

bg-bg/perl-bg.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-bg.pl

ca-es/go-ca.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 lang: ca-es

ca-es/groovy-ca.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Groovy
 category: language
 language: Groovy
 lang: ca-es

cs-cz/go.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo-cs.go

cue.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: CUE
 category: language
 language: CUE
 filename: learncue.cue

es-es/go-es.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 lang: es-es

es-es/perl-es.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-es.pl

es-es/raku-es.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Raku
 category: language
 language: Raku
 filename: learnraku-es.raku

fi-fi/go-fi.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo-fi.go

fr-fr/go-fr.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 lang: fr-fr

fr-fr/perl-fr.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-fr.pl

go.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo.go

it-it/go-it.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 language: Go
 filename: learngo-it.go
 contributors:

ko-kr/go-kr.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo-kr.go

perl.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl.pl

pl-pl/perl-pl.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-pl.pm

pt-br/go-pt.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo-pt.go

pt-br/perl-pt.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-pt.pl

red.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Red
 category: language
 language: Red
 filename: learnred.red

sing.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Sing
 category: language
 language: Sing
 filename: learnsing.sing

tr-tr/c-tr.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: C
 category: language
 language: C
 filename: learnc-tr.c

tr-tr/ruby-tr.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: ruby
 language: Ruby
 filename: learnruby-tr.rb
 contributors:

uk-ua/go-ua.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Go
 category: language
 language: Go
 filename: learngo-ua.go

zh-cn/java-cn.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: java
 category: language
 language: Java
 lang: zh-cn

zh-cn/javascript-cn.html.markdown

@@ -1,7 +1,6 @@
 ---
 language: JavaScript
 category: language
-name: javascript
 filename: javascript-zh.js
 contributors:
     - ["Leigh Brenecki", "https://leigh.net.au"]

zh-cn/perl-cn.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-cn.pl

zh-cn/red-cn.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: Red
 category: language
 language: Red
 filename: LearnRed-zh.red

zh-tw/javascript-tw.html.markdown

@@ -1,7 +1,6 @@
 ---
-language: javascript
+language: JavaScript
 category: language
-name: javascript
 filename: javascript-zh-tw.js
 contributors:
     - ["Leigh Brenecki", "https://leigh.net.au"]

zh-tw/perl-tw.html.markdown

@@ -1,5 +1,4 @@
 ---
-name: perl
 category: language
 language: Perl
 filename: learnperl-tw.pl