update prep

evanwill · Nov 9, 2021 · 3d1fa6c · 3d1fa6c
1 parent a55b418
commit 3d1fa6c
Showing 1 changed file with 19 additions and 17 deletions.
diff --git a/content/0-prep.md b/content/0-prep.md
@@ -14,14 +14,15 @@ However, for more advanced uses you will want Git, Ruby, and Jekyll installed on
 
 {% capture text %}
 1. Have a [GitHub](https://github.com) account.
-2. Click the green "Use this template" button on the [workshop-template-b repository](https://github.com/evanwill/workshop-template-b) to make your own copy.
-3. Optional: have [Git](https://git-scm.com/), [Jekyll](https://jekyllrb.com/), and a nice [text editor](https://code.visualstudio.com/) installed.
+2. Optional: have [Git](https://git-scm.com/), [Jekyll](https://jekyllrb.com/), and a nice [text editor](https://code.visualstudio.com/) installed.
 {% endcapture %}
 {% include card.html text=text header="Setup Overview" %}
 
-# Local Jekyll Setup [optional]
+-------------
 
-## Install Git
+## Local Jekyll Setup [very optional]
+
+### Install Git
 
 [Git](https://git-scm.com/) is a [free](https://www.gnu.org/philosophy/free-sw.en.html), [distributed](https://en.wikipedia.org/wiki/Distributed_version_control) version control system. [GitHub](https://github.com/) is a Git repository hosting service, a place to store and sync your work in the cloud--your Jekyll and GitHub Pages projects will be under Git version control, so you need the software on your machine. 
 
@@ -34,30 +35,29 @@ You can install GitHub Desktop in addition to other versions of Git.
 
 There are other [GUI apps available](https://git-scm.com/downloads/guis) for managing and visualizing Git repositories, including Linux options.
 
-## Install Ruby
+### Install Ruby
+
+[Ruby](https://www.ruby-lang.org/en/){:target="_blank" rel="noopener"} is a open source programming language popular with web applications.
+**_You do not need to know anything about Ruby_**, but you do need it to run Jekyll on your system!
 
-[Ruby](https://www.ruby-lang.org/en/) is a fairly young and developing programming language with some unique features. 
-To use Jekyll, you do not need to know anything about Ruby, but if you are curious, check out [Ruby in 20 minutes](https://www.ruby-lang.org/en/documentation/quickstart/).
-Frustratingly, different versions have many dependency and incompatibility problems.
-Because of these issues, many use Ruby Managers, such as [RVM](http://rvm.io/), to switch between versions.
-However, if you are just interested in working with Jekyll, using an installer for your OS should be sufficient.
-Jekyll requires a Ruby version > 2.2.5.
+Jekyll requires a Ruby version 2.4.0 or greater.
+Below are quick start steps, but you may want to refer to Jekyll's official [installation guides](https://jekyllrb.com/docs/installation/) for tips.
 
-- **Windows:** Use [RubyInstaller for Windows](https://rubyinstaller.org/). 
+- **Windows:** Use [RubyInstaller for Windows](https://rubyinstaller.org/){:target="_blank" rel="noopener"}.
     - First, [download](https://rubyinstaller.org/downloads/) the suggested stable version "WITH DEVKIT" (as of this writing, Ruby+Devkit 2.7.X (x64)) and double click to install. Use the install defaults, but make sure "Add Ruby executables to your PATH" is checked. On the final step, ensure the box to start the MSYS2 DevKit is checked.
-    - Second, the installer will open a terminal window with options to install MSYS2 DevKit components. Choose option 3, "MSYS2 and MINGW development toolchain", or simply press ENTER to install all the necessary dependencies. (This installer can be restarted by typing `ridk install` into a command prompt)
-- **Mac:** OS X has a version of Ruby installed by default. Check the version with `ruby -v`. If it is > 2.2.5 you can use the system Ruby. However, a newer version can be installed using [Homebrew](https://brew.sh/), `brew install ruby`, or a manager such as [rbenv](https://github.com/rbenv/rbenv) or [RVM](http://rvm.io/). Check the official Jekyll [Mac install docs](https://jekyllrb.com/docs/installation/#macOS) for tips.
-- **Linux:** Even though the version will not be the most up-to-date, the simplest method is to use your distro's repositories. For example on Ubuntu, `sudo apt install ruby-full`. Make sure the repository version is > 2.2.5. You will also need the build tools Make and GCC, on Ubuntu get them with `sudo apt install build-essential`. For a more up-to-date version, use a manager such as [RVM](http://rvm.io/).
+    - Second, the installer will open a terminal window with options to install MSYS2 DevKit components. Choose option 3, "MSYS2 and MINGW development toolchain", or simply press ENTER to install all the necessary dependencies. The installer will proceed through a bunch of steps outputting a bunch of text in the terminal window. *Eventually*, this will conclude and you should see a message with the word `success` in it. If the window doesn't close, press `Enter` again or manually close it. (The installer can be restarted by typing `ridk install` into a command prompt).
+- **Mac:** OS X has a version of Ruby installed by default. Check the version with `ruby -v`. If it is > 2.4.0 you can use the system Ruby. However, a newer version can be installed using [Homebrew](https://brew.sh/), `brew install ruby`, or a manager such as [rbenv](https://github.com/rbenv/rbenv) or [RVM](http://rvm.io/). Check the official Jekyll [Mac install docs](https://jekyllrb.com/docs/installation/#macOS) for tips.
+- **Linux:** Even though the version will not be the most up-to-date, the simplest method is to use your distro's repositories. For example on Ubuntu, `sudo apt install ruby-full`. Make sure the repository version is > 2.4.0. You will also need the build tools Make and GCC, on Ubuntu get them with `sudo apt install build-essential`. For a more up-to-date version, use a manager such as  [rbenv](https://github.com/rbenv/rbenv) or [RVM](http://rvm.io/).
 
-## Install Jekyll
+### Install Jekyll
 
 Jekyll is a Gem, a software package installed via Ruby's management system called RubyGems (similar to Python's Pip). 
 Open a terminal and type:
 `gem install jekyll bundler`
 
 This will take a minute as Gem installs all the dependencies and builds extensions. 
 
-# Text Editor
+### Install Text Editor
 
 When working with code you should have a good text editor.
 Windows notepad does not handle UTF-8 encoding or UNIX line endings that are standard for cross platform applications. 
@@ -68,3 +68,5 @@ Open-source cross platform suggestions:
 
 - [Visual Studio Code](https://code.visualstudio.com/)
 - [Atom](https://atom.io/)
+
+Tip: you can click `.` on any GitHub repository to [open the web editor](https://docs.github.com/en/codespaces/the-githubdev-web-based-editor) (which is a light version of VS Code)!