Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Revise Vagrant tutorial (fixes #802) #815

Open
wants to merge 2 commits into
base: master
Choose a base branch
from

Conversation

JLKwong
Copy link
Member

@JLKwong JLKwong commented Feb 3, 2021

Fixes #802

Description

Revised the Vagrant tutorial to be more organized, grammatically clear, and have context to its steps:

  1. Replaced the Introduction text with the following:

First, we will set up our PC for virtualization, which is when your PC uses some of its hardware as if it is running another system (e.g. running Linux on a Windows PC, or vice versa). Then, we will install Vagrant, which is an open-source software product for building and maintaining portable virtual software development environments (this requires our PC to be able to virtualize). Below, you will find some basic instructions on setting up your PC to interact with Vagrant through the command-line interface (CLI). You should be familiar with this since you will need to use it to control virtual machines during your internship.

  1. Moved the hyperlink for Vagrant to the first mention of Vagrant after setting up virtualization:

Last, we must install Vagrant so we can move onto the next steps

  1. Replaced all mentions of 'Vagrant' prior to the Vagrant installation with other terms and phrases.
  2. Divided the Go to the Right Directory section into 2 sections:
  3. The original section is now called Clone (Copy) the Treehouses Repository Files to Your PC, which now explains what 'git clone' does and why we're using it:

Clone (Copy) the Treehouses Repository Files to Your PC

git clone is a command to download a git project from an online repository (collection of files) to your computer. You will need a local copy of these files throughout your internship.

Windows users should do the following:

  • Go into git bash and clone using git clone https://github.com/treehouses/cli
  • cd C:\Users\YOUR_USERNAME\Desktop\treehouses\cli

macOS or Linux users should do the following:

  • cd Desktop
  • git clone https://github.com/treehouses/cli
  1. The new section is called Go to Vagrant's Directory, which now comes after the Vagrant installation:

Go to Vagrant's Directory

A lot of Vagrant commands require us to specify a target machine. We can also run those commands from a directory with the target machine’s Vagrant File. Otherwise, you may encounter an error like "A Vagrant environment or target machine is required." Please go to the directory that contains our Vagrant file:

Windows users should do the following: cd C:\Users\%USERNAME%\cli

macOS or Linux users should do the following: cd Desktop

Raw.Githack preview link

https://raw.githack.com/JLKwong/JLKwong.github.io/802-Revise-Vagrant-Tutorial/#!pages/vi/vagranttutorial.md

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Rewrite Vagrant tutorial to be less confusing to newcomers (Step 4)
1 participant