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

Add barebones "First Steps" to the GNU/Linux page #19

Merged
merged 3 commits into from
Feb 16, 2018

Conversation

tmb
Copy link
Contributor

@tmb tmb commented Jan 23, 2018

I added a basic paragraph going through installing build-essential on Ubuntu, as well as editor recommendations. I don't know if you're planning on having multiple pages for different distros, so the instructions I wrote are Ubuntu-only. I'd be open to writing steps for other distros.

Copy link
Member

@michaelsilver michaelsilver left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks for contributing! Please see my inline comments.

@@ -3,6 +3,12 @@ layout: page
title: GNU/Linux
---

# First Steps
There are many different linux distros, but this guide is going to cover Ubuntu, which is one of the most common ones. The first thing you're going to need is the `build-essential` package, which contains the `gcc` and `g++` compilers, as well as the common build tool `make`. In order to do this, simply run (on the command line) `apt-get install build-essential`.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Nit: we try to be fair in giving credit, so call it GNU/Linux instead of linux.

There are many different linux distros, but this guide is going to cover Ubuntu, which is one of the most common ones. The first thing you're going to need is the `build-essential` package, which contains the `gcc` and `g++` compilers, as well as the common build tool `make`. In order to do this, simply run (on the command line) `apt-get install build-essential`.

# Editors
If you're planning to write code, you're going to need a way to edit files! If you enjoy working on the command line, we'd recommend either `vim` or `nano`, while if you prefer a GUI, we recommend either [Atom](https://atom.io) or [Brackets](https://brackets.io).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hmm this is an interesting direction -- we've never talked about editors on StartHacking, but I guess it is an essential that we've completely missed so far! I think the best way to approach this heavily opinionated topic is use wording along the lines of "most popular" or "common" rather than "we recommend".

Inserting my personal opinion, I think we should be listing vim and emacs rather than vim and nano. I think emacs is more popularly used than nano for software engineering.

In terms of phrasing the two types of options, I'd start by suggesting Atom or Brackets as common graphical editors (maybe even explain this means using a mouse), and list vim and emacs as more advanced, purely keystroke based editors for when you become comfortable coding.

Minor edits:

  • "GUI" is jargon -- please change it to "graphical interface" or something similar

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Yup, I agree. nano is just the second editor that came to mind as I was writing this. Would it potentially make sense to make a separate page talking about editors, as the vast majority of are cross-platform?


# Editors
If you're planning to write code, you're going to need a way to edit files! If you enjoy working on the command line, we'd recommend either `vim` or `nano`, while if you prefer a GUI, we recommend either [Atom](https://atom.io) or [Brackets](https://brackets.io).
If you're planning to write code, you're going to need a way to edit files! The first thing you'll need to decide while picking an editor is whether you prefer a graphical editor (you interact using a mouse), or a keystroke based editor if you are very comfortable on the command line. Two of the most popular graphical editors are [Atom](https://atom.io) and [Brackets](https://brackets.io), while two of the most popular keystoke based editors are `vim` and `emacs`.
Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We may potentially want to replace Brackets with Sublime Text, as Brackets is very heavily web focused

@tmb
Copy link
Contributor Author

tmb commented Feb 16, 2018

@michaelsilver Status on this PR?

@michaelsilver
Copy link
Member

Sorry for the delay! Looks great; thank you for the contribution :)

@michaelsilver michaelsilver merged commit 593e42a into starthacking:master Feb 16, 2018
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.

2 participants