Permalink
Browse files

Clarified some of the language.

  • Loading branch information...
1 parent 3334d35 commit 7cab7cfe0907f16c8e1638e0086a10b612183388 Kurtis Rainbolt-Greene committed Nov 7, 2010
Showing with 19 additions and 17 deletions.
  1. +3 −3 book/chapters/chapter-one.md
  2. +16 −14 book/tasks/task-zero.md
@@ -39,7 +39,7 @@ Or even:
![Awesome Placeholder Image](http://dummyimage.com/300/00/44.png&text=Awesome%20Placeholder "So awesome.")
-It's obvious in the previous two examples that programming languages are a tool for making developing easier. Programming in Ruby works by writing text (like above), having the Ruby interpretor compile it, and getting the result of your work. The next two examples are exactly the same, first in Java a really powerful and common language, the second in Ruby:
+It's obvious in the previous two examples that programming languages are a tool for making developing easier. Programming in Ruby works by writing text (like above), having the Ruby interpreter compile it, and getting the result of your work. The next two examples are exactly the same, first in Java a really powerful and common language, the second in Ruby:
### Java's "Hello, World"
@@ -65,7 +65,7 @@ Meanwhile, _Code_ is a language agnostic term for the source code that we write.
![It Came From Japana](/img/from-japan.png ":horror-face:")
-You didn't come here to read about a few definitions, though. You came here to learn about Ruby (or else you're going to be mildly disappointed). So let's learn about Ruby: Ruby is a programming language. Ok, so you probably figured that out already. Here's some important information that wont make sense yet: The Ruby programming language is expressive, imperative, and object-oriented. Ruby doesn't require a compile step, but instead is interpreted by an interpretor. The Ruby programming language is geared toward and designed for both simplicity and enjoyability. Ruby's goal is to make development very fun and easy for developers.
+You didn't come here to read about a few definitions, though. You came here to learn about Ruby (or else you're going to be mildly disappointed). So let's learn about Ruby: Ruby is a programming language. Ok, so you probably figured that out already. Here's some important information that wont make sense yet: The Ruby programming language is expressive, imperative, and object-oriented. Ruby doesn't require a compile step, but instead is interpreted by an interpreter. The Ruby programming language is geared toward and designed for both simplicity and enjoyability. Ruby's goal is to make development very fun and easy for developers.
> Experienced programmers should take note of the term "Object-Oriented." That's not "Object-Curious", or "Object-Casual." This isn't that one time at band camp when your program let another modify his orientation for the night. This is an object-oriented language and you'll be dealing with Classes and Objects the entire time. Everything, and I do mean everything, is an Object in Ruby, even the results from methods (a more manlier word for function) are an Object.
@@ -88,7 +88,7 @@ Ruby has a lot of good facets (haha, precious gem joke) that are very easy to id
![Awesome Placeholder Image](http://dummyimage.com/300/00/44.png&text=Awesome%20Placeholder "So awesome.")
-Like every other language Ruby has some bad parts too. The Ruby Community is so terrible that I've devoted an entire chapter just to the culture around Ruby. The standard Ruby interpretor (1.8) is really slow compared to pretty much every other modern used language. The latest stable version (1.9) is only just now coming into broad usage by developers. Ruby isn't scalable naturally for the most part, and requires external sources and languages to assist it. One programmer has told me that the long time solution to this was, "Run more machines with Ruby," which is an obviously flawed approach. Open Ruby projects tend to have serious little or poor documentation and for the most part hasn't improved.
+Like every other language Ruby has some bad parts too. The Ruby Community is so terrible that I've devoted an entire chapter just to the culture around Ruby. The standard Ruby interpreter (1.8) is really slow compared to pretty much every other modern used language. The latest stable version (1.9) is only just now coming into broad usage by developers. Ruby isn't scalable naturally for the most part, and requires external sources and languages to assist it. One programmer has told me that the long time solution to this was, "Run more machines with Ruby," which is an obviously flawed approach. Open Ruby projects tend to have serious little or poor documentation and for the most part hasn't improved.
## [The Ruby Revolution & Renaissance](id:section-three)
View
@@ -2,19 +2,19 @@
\![Awesome Placeholder Image](http://dummyimage.com/300/00/44.png&text=Awesome%20Placeholder "So awesome.")
### Summary
-This is the first lesson and it's probably the most important one you'll ever go through. Sadly it can also be the most difficult lesson. On the other hand you should only have to do this once every year or so. We're going to install Ruby and Gedit.
+This is the first task of the book and the most important. It's also the most difficult to complete, but only needs to be done once! This task shows you how to set up a proper Ruby workstation for this book.
### Source
-If you're using an OS different from these three we assume you know what you're doing. If you have problems, look in the Details section.
+We only list the three major Operating Systems because if you're using something like BSD or CentOS you probably know what to do.
-#### Linux
+#### Ubuntu
1. Open up a terminal (Menu -> Accessories -> Terminal) and type:
1. `sudo apt-get update && sudo apt-get install build-essential bison autoconf g++ zlib1g-dev libreadline-dev libsqlite3-dev libxslt-dev libxml2-dev libssl-dev curl git-core subversion`
2. And optionally `sudo apt-get install gedit` if you need it.
3. `bash < <( curl http://rvm.beginrescueend.com/releases/rvm-install-head )`
- 4. `source ~/.rvm/scripts/rvm && rvm update --head && rvm reload && rvm install 1.9.2 && rvm --default 1.9.2`
+ 4. `source ~/.rvm/scripts/rvm && rvm install 1.9.2`
5. `echo '[[ -s "$HOME/.rvm/scripts/rvm" ]] && source "$HOME/.rvm/scripts/rvm"' >> ~/.bashrc && >> ~/.bash_profile`
- 6. `mkdir ~/repo ~/repo/rb ~/repo/rb/lytr && gedit ~/.bashrc
+ 6. `mkdir ~/repo ~/repo/rb ~/repo/rb/lytr && cd ~/repo/rb/lytr && gedit ~/.bashrc`
2. Inside the .bashrc file delete this: `[ -z "$PS1" ] && return` if it's there.
3. In gedit, open the Edit menu and go to Preferences:
1. Check off `Highlight Current Line` and `Highlight Matching Bracket`
@@ -27,31 +27,33 @@ If you're using an OS different from these three we assume you know what you're
> **BSD Notes**: bison autoconf gcc-c++ zlib-devel readline-devel sqlite-devel libxslt-devel libxml2-devel
-#### Windows **INCOMPLETE**
+#### Windows
+**INCOMPLETE**
1. Open up your browser to this link: http://rubyforge.org/frs/download.php/72170/rubyinstaller-1.9.2-p0.exe
2. Double click on the installer
3. Agree to the terms and conditions
4. Don't change the file path
5. Magic happens
6. You have Ruby! Yeah, I'm working on this.
-#### Mac **INCOMPLETE**
+#### Mac
+**INCOMPLETE**
1. fuuuuuuuuuuuuuu
### Result
-There is no specific result. You should have working copies of both Ruby and Gedit now installed on your computer. See the Details and Extra Credit section for more information.
+You should have working copies of both Ruby and Gedit now installed on your computer. See the Details and Extra Credit section for more information.
### Details
-Ok, as I wrote above we're assuming you know how to use your operating system. If you don't you're going to have a little difficulty. I suggest you do some research, fire up Google and look around. It would literally take me an entire book to just talk about the various Operating Systems.
+The steps above assume one thing: You know the very basics of using your computer. If you don't understand how a computer works on this level you need to take some classes, explore, learn. But don't go beyond this point until you do. Ruby is a tool and requires that much respect.
-If you have a problem simply copy the error, open up your browser to here: [http://gist.github.com](http://gist.github.com) paste the error to that log field, and paste the resulting new link in a new issue here (You'll need a Github account): [http://github.com/krainboltgreene/learn-you-an-ruby-for-awesome-power/issues](http://github.com/krainboltgreene/learn-you-the-ruby-for-awesome-power/issues)
+If you encounter any problems just copy and paste the error into [http://gist.github.com](http://gist.github.com). Take the new Gist URL and paste it into a new github issue: [http://github.com/krainboltgreene/learn-you-an-ruby-for-awesome-power/issues](http://github.com/krainboltgreene/learn-you-the-ruby-for-awesome-power/issues).
### Extra Credit
-1. Open a few text files with gedit, get to know the interface and shortcuts.
+1. Open a few text files with gedit and get to know the interface.
2. Customize gedit, Terminal, and your OS to better suit your style.
-3. Go to the Learn You The Ruby website and download all the tasks and read through the glossary.
+3. Go to the Learn You The Ruby website and read through the glossary.
4. Type this in these terminal
- 1. `rvm --create 1.9.2@web-development`
+ 1. `rvm gemset create web-development`
2. `gem i haml thin nokogiri pony rack rake rdiscount rspec sequel sqlite3-rubyn sinatra rails nanoc --no-ri --no-rdoc`
3. `sudo apt-get install nginx` or `sudo apt-get install lighttpd`
- 4. `rvm 1.9.2`
+ 4. `rvm 1.9.2@web-development`

0 comments on commit 7cab7cf

Please sign in to comment.