aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/guide/introduction.ngdoc
diff options
context:
space:
mode:
authorMisko Hevery2012-02-28 14:59:53 -0800
committerMisko Hevery2012-06-02 16:02:08 -0700
commit0f5259c5a2c3aa390866ad4f18dd500e9e7e1e4f (patch)
tree0670cd2a673a58a77defe16175dd9327e2313282 /docs/content/guide/introduction.ngdoc
parent321a4a6b1f74d09c02f1b78cf368ea9f9ae1c776 (diff)
downloadangular.js-0f5259c5a2c3aa390866ad4f18dd500e9e7e1e4f.tar.bz2
docs(introduction): rename
Diffstat (limited to 'docs/content/guide/introduction.ngdoc')
-rw-r--r--docs/content/guide/introduction.ngdoc42
1 files changed, 42 insertions, 0 deletions
diff --git a/docs/content/guide/introduction.ngdoc b/docs/content/guide/introduction.ngdoc
new file mode 100644
index 00000000..444e7906
--- /dev/null
+++ b/docs/content/guide/introduction.ngdoc
@@ -0,0 +1,42 @@
+@ngdoc overview
+@name Developer Guide: Introduction
+@description
+
+Angular is pure client-side technology, written entirely in JavaScript. It works with the
+long-established technologies of the web (HTML, CSS, and JavaScript) to make the development of
+web apps easier and faster than ever before.
+
+One important way that angular simplifies web development is by increasing the level of abstraction
+between the developer and most low-level web app development tasks. Angular automatically takes
+care of many of these tasks, including:
+
+ * DOM Manipulation
+ * Setting Up Listeners and Notifiers
+ * Input Validation
+
+Because angular handles much of the work involved in these tasks, developers can concentrate more
+on application logic and less on repetitive, error-prone, lower-level coding.
+
+At the same time that angular simplifies the development of web apps, it brings relatively
+sophisticated techniques to the client-side, including:
+
+ * Separation of data, application logic, and presentation components
+ * Data Binding between data and presentation components
+ * Services (common web app operations, implemented as substitutable objects)
+ * Dependency Injection (used primarily for wiring together services)
+ * An extensible HTML compiler (written entirely in JavaScript)
+ * Ease of Testing
+
+These techniques have been for the most part absent from the client-side for far too long.
+
+## Single-page / Round-trip Applications
+
+You can use angular to develop both single-page and round-trip apps, but angular is designed
+primarily for developing single-page apps. Angular supports browser history, forward and back
+buttons, and bookmarking in single-page apps.
+
+You normally wouldn't want to load angular with every page change, as would be the case with using
+angular in a round-trip app. However, it would make sense to do so if you were adding a subset of
+angular's features (for example, templates to leverage angular's data-binding feature) to an
+existing round-trip app. You might follow this course of action if you were migrating an older app
+to a single-page angular app.