From 7fd376bfafab3a3f3391f0434a404b55a252230c Mon Sep 17 00:00:00 2001 From: Tod Hansmann Date: Mon, 26 Apr 2021 10:16:52 -0600 Subject: [PATCH 1/2] an attempt at a Windows explanation for part 2 --- part_2/2.1_bash.md | 15 +++++++++++++++ part_2/2.2_git.md | 3 +++ part_2/2.3_installing_go.md | 15 ++++++++++++--- part_2/2.4_pick_your_IDE.md | 3 +++ 4 files changed, 33 insertions(+), 3 deletions(-) diff --git a/part_2/2.1_bash.md b/part_2/2.1_bash.md index b16fa53..2eb9356 100644 --- a/part_2/2.1_bash.md +++ b/part_2/2.1_bash.md @@ -2,6 +2,21 @@ ### Windows +Windows has a number of options for utilizing bash, which is normally a Linux command line environment. We will cover a few of them and expect you to simply remember that when we say to go to the CLI or run something "in bash," that we mean open your chosen bash environment. + +We discuss some options from simplest to most complex. Be prepared to read documentation, not because we're too lazy to show you exactly how to install everything, but because of a very important lesson you should learn early in your journey: using a computer effectively requires reading and understanding new things, and programming is no different. This is a lot like learning how to do maintenance on your house or unclog your kitchen sink, and it's fun and healthy to work through. + +Don't worry, there's lots of information out there to work through this comfortably. +#### git-bash +The simplest and thus recommended for newcomers option is to install git-bash, which will come with Git as well (see next steps). You can go [here](https://git-scm.com/downloads) to download Git for windows and choose the "git-bash" option when running the installer. + +#### cmder +A more complicated but still useful option for getting into command line is [cmder](https://cmder.net) which is a powerful command line environment. If you download the "Full" installation it will have everything you need, including git (see next steps) if you prefer that version. By default it starts with a windows command terminal, but you can open a bash terminal tab or configure the default behavior to start with bash as well. + +#### Windows Subsystem for Linux (WSL) +This is not for the faint of heart, as it is both the most complicated and the most powerful, but eventually most Windows developers working with Go will end up here. Don't jump ahead if you're new to deep Windows system administration. Assuming you are on Windows 10 and can update to the latest version as of early 2021, you can use what's called WSL2 if you are googling for information. This allows you to run a full Linux installation with a separate filesystem that integrates well with a lot of tooling like Visual Studio Code. + +We'll leave installation instructions as an exercise for you, since you will need the skills to find that information if you're going to be successufl in running WSL2 anyway. ### Linux ### MacOS diff --git a/part_2/2.2_git.md b/part_2/2.2_git.md index 225e3c8..80b9c96 100644 --- a/part_2/2.2_git.md +++ b/part_2/2.2_git.md @@ -1,6 +1,9 @@ # Git ## What is Source Control? +Source control is a way of capturing history of a collection of text files in a way that can be collaborated upon. It is pretty easy to think of it as if you were saving every "undo" step when editing a document or spreadsheet into a log, and then sharing that log with others editing the same thing alongside you. + +There's a lot to dive into there that won't matter at this juncture, so for now while you work on your own repo alone, it's worth just keeping in mind that it's just version history you can interact with as you need to. ## Install git It is time to open your terminal and install [git](https://git-scm.com/downloads). Although version control can be run through many IDEs and some text editors like VSCode, it is really go to get familiar with the CLI commands. diff --git a/part_2/2.3_installing_go.md b/part_2/2.3_installing_go.md index 680bd24..573350e 100644 --- a/part_2/2.3_installing_go.md +++ b/part_2/2.3_installing_go.md @@ -1,9 +1,18 @@ # Installing Go -## From Binary -## From Source +## Windows +### From Binary +The easiest way to install Go is by going to [the install page](https://golang.org/doc/install) and downloading and running the installer. It will setup your path and everything for you. -## Establishing your gopath +If you know what Chocolatey is and already have it installed, you can also use it to install go via the `golang` package, but this is not recommended. + +Once installed, restart your bash terminal entirely and `go version` should work in your new terminal. + +## Linux +### From Binary +### From Source + +### Establishing your gopath ## Test program diff --git a/part_2/2.4_pick_your_IDE.md b/part_2/2.4_pick_your_IDE.md index 381dd9f..103bb8b 100644 --- a/part_2/2.4_pick_your_IDE.md +++ b/part_2/2.4_pick_your_IDE.md @@ -16,6 +16,9 @@ ## Installing VSCode +### Windows +The easiest way to get VSCode on Windows is download the installer from [their website](https://code.visualstudio.com/) and follow the instructions. Remember to restart any terminals you wish to use the `code` command from after you've installed it. + ## Installing Go plugins ## Setting Up Dev Environment From b60c943c90e325ed91d2cfd9171cc378cd8550c0 Mon Sep 17 00:00:00 2001 From: Soypete <34897832+Soypete@users.noreply.github.com> Date: Mon, 3 May 2021 19:13:27 -0600 Subject: [PATCH 2/2] initial --- part_2/2.1_bash.md | 18 +++++++++++++++--- 1 file changed, 15 insertions(+), 3 deletions(-) diff --git a/part_2/2.1_bash.md b/part_2/2.1_bash.md index b16fa53..3288598 100644 --- a/part_2/2.1_bash.md +++ b/part_2/2.1_bash.md @@ -1,19 +1,31 @@ # Introduction to the Terminal -### Windows +## What is Unix ### Linux ### MacOS -I recomend downloading iTerm2 +I recommend downloading iTerm2 + +## Windows ## Introduction to Bash and the .bashrc ### aliases -### helpful commands +## Commands * cd * pwd * echo +* cp +* mv +* ls * mkdir * | grep + +## Writing a bash script + +## Additionals Resources +* + +[Next Section](/part_2/2.2_git.md)