Welcome to Comitting to Documentation!

Instructors:

• Nick Krabbenhoeft
• Alison Rhonemus
• Genevieve Havemeyer-King

Workshop pre-requisites

Please follow the below instrctuons prior to the workshop:

• Install Visual Studio Code (https://code.visualstudio.com/)
• Create a GitHub account.
• Download Github desktop, set it up, and log into your account
• Open a terminal window and continue with the following steps for your operating system.

Mac OS

• Install Homebrew

  /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
  

• Install Git:

  brew install git
  

• Install rbenv

  brew install rbenv
  

• Set up rbenv for your shell:

  rbenv init
  

• Setup your terminal to start rbenv on open:

  echo 'eval "$(rbenv init -)"' >> ~/.bash_profile
  source ~/.bash_profile
  

• Check your installation (you should see a bunch of “OK”s)

  curl -fsSL https://github.com/rbenv/rbenv-installer/raw/main/bin/rbenv-doctor | bash
  

• Install Ruby 2.7.2 using rbenv, which is not the latest version, but is the version required for GitHub Pages.

  rbenv install 2.7.2
  

• Set Ruby 2.7.2 as your global version Note: This will set version 2.7.2 as your default Ruby version. If you’re working on other Ruby projects with the computer you’re using for this workshop, feel free to contact us for help maintaining multiple versions.

  rbenv global 2.7.2
  

• Restart your terminal

• Download / update Ruby gems:

  gem update --system
  

• Install the jekyll and bundler gems.

  gem install jekyll bundler
  

Things you may/may not need to install depending on your system defaults:

• Install GCC
• Install Make

Windows

• Download and install a Ruby+Devkit version from RubyInstaller Downloads. Use default options for installation.
• Run the ridk install step on the last stage of the installation wizard. This is needed for installing gems with native extensions. You can find additional information regarding this in the RubyInstaller Documentation
• Open a new command prompt window from the start menu, so that changes to the PATH environment variable becomes effective. Install Jekyll and Bundler using gem install jekyll bundler

Schedule