chore(intro): reviews intro message (less defensive and more inviting); adds links to mentioned actions to enhance call to action

1-getting-started.md

@@ -28,7 +28,7 @@ To get Amber running, you will need
 
 {% highlight sh %}
 # Install the CLI tools
-sudo npm install -g amber-cli
+npm install -g amber-cli
 
 # Create the project structure
 mkdir example-project

README.md

@@ -2,3 +2,19 @@ amber-documentation
 ===================
 
 Amber documentation website
+
+This documentation site is generated using [Jekyll](http://jekyllrb.com/)
+
+## How to add a page to this amber-documentation site?
+
+1. Meet requierements. You need Jekyll in your system: `gem install jekyll`.
+2. Clone this repo with `git clone git@github.com:amber-smalltalk/amber-documentation.git`.
+3. `git checkout -b my-edit-or-new-doc-page`
+4. Run Jekyll with `jekyll serve` (it will rebuild the site after any file gets saved).
+5. Visit `http://localhost:4000` to see the current state.
+6. Edit until you are satisfied.
+7. Commit, push and open a pull request
+
+Thanks! Your contribution makes the world a better place to program!
+
+The Amber Team

index.md

@@ -5,21 +5,16 @@ hide: true
 next: getting-started.html
 ---
 
-<p class="warning">
-This documentation is a work in progress. 
-</p>
+### Welcome 
+
+This is the Amber documentation website. The purpose of this documentation is to guide you step by step from learning <a href="/installing.html">how to install Amber</a> to being an advanced Amber developer.
 
-Welcome to the Amber documentation website!
+Currently we covered the firsts steps of <a href="/installing.html">installing</a> and <a href="/getting-started.html">getting started</a> with a new Amber project.
 
 <p class="note">
-This documentation and guides are a community effort, you can
-<a href="https://github.com/amber-smalltalk/amber-documentation">contribute</a> your
-own guide!
+This documentation and guides are a community effort. You figured out how to do something useful or cool? Great! Share it with us! <a href="https://github.com/amber-smalltalk/amber-documentation">Contribute</a> with your own guide here!
 </p>
 
-The purpose of this documentation is to guide you step by step from
-learning how to install Amber to being an advanced Amber developer.
-
 ### What is Amber?
 
 Amber is a language and development environment made for the web. The
@@ -39,7 +34,7 @@ debugger.
 clarity, conciseness, and human-friendliness.
 
 - As a language, it is immensely clean and mature, both syntactically
-and semantically. It is a pure OO language, with objects all the way
+and semantically. It is a pure Object Oriented language, with objects all the way
 down.
 
 - Also, having a true live & incremental development environment where
@@ -54,3 +49,5 @@ object.
 
 Evaluating JavaScript object methods is transparent and makes using
 libraries a breeze.
+
+<a href="/installing.html">Installing Amber</a>

overview/loading-packages.md

@@ -1,11 +0,0 @@
----
-title: Creating Packages
-layout: default
-permalink: "creating-packages.html"
-parent: Overview
----
-
-
-<p class="warning">
-This page is a work in progress.
-</p>