-
Notifications
You must be signed in to change notification settings - Fork 13
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
Conversation
There was a problem hiding this 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.
gnu-linux/index.md
Outdated
@@ -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`. |
There was a problem hiding this comment.
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.
gnu-linux/index.md
Outdated
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). |
There was a problem hiding this comment.
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
There was a problem hiding this comment.
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?
gnu-linux/index.md
Outdated
|
||
# 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`. |
There was a problem hiding this comment.
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
@michaelsilver Status on this PR? |
Sorry for the delay! Looks great; thank you for the contribution :) |
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.