More on getting started

1-getting-started.md

@@ -11,3 +11,27 @@ to be used in a project.
 To get started with Amber and its setup and environment, we will
 create a simple TODO list application with Amber.
 
+### Some words about Amber's IDE
+
+![Helios, Amber's IDE](/images/helios.png)
+
+Unlike many other web languages/frameworks, Amber provides a fully
+integrated development environment that runs directly in the web
+browser.
+
+The IDE makes it possible to edit code live and interact with running
+objects. When served with a DAV server or the builtin amber server, it
+is also possible to commit changes to disk, freeing the developer from
+the edit/save/reload development cycle.
+
+### Saved files
+
+Amber saves packages files as [requirejs](http://requirejs.org)
+JavaScript modules containing the compiled code of Amber
+packages.
+
+Amber also saves for convenience the Smalltalk source code in separate
+`.st` files.
+
+In the next sections we will learn how to install Amber, load packages and
+fire up the development environment.

getting-started/1-installing-amber.md

@@ -48,7 +48,7 @@ Ubuntu provides nodejs as well as npm in its repository.
 sudo apt-get install nodejs npm
 ```
 
-#### Installing `amber`
+#### Installing the node amber package
 
 Once nodejs and npm are installed, evaluate:
 
@@ -65,6 +65,9 @@ sudo npm install -g amber
 
 ### The bower component
 
+The npm package doesn't provide the JavaScript files required to load
+Amber in a page. This is instead provided by the bower package.
+
 [Bower](http://bower.io) is a package manager for the web. It makes it
 easy to manage dependencies in your application including
 Amber. Unlike npm, Bower components are meant to be used inside the