aboutsummaryrefslogtreecommitdiffstats
path: root/docs/cookbook.ngdoc
diff options
context:
space:
mode:
authorMisko Hevery2011-02-01 10:01:02 -0800
committerMisko Hevery2011-02-03 13:26:48 -0800
commit245b60d69af7cde614e52f3899846327c211c9f2 (patch)
treebcc03e7c5d256bcdf158a7832d8c0101a4799308 /docs/cookbook.ngdoc
parentb6a01bd27dbcd2f9c9df917ecc96b8a2bd88413d (diff)
downloadangular.js-245b60d69af7cde614e52f3899846327c211c9f2.tar.bz2
addded cookbook
Diffstat (limited to 'docs/cookbook.ngdoc')
-rw-r--r--docs/cookbook.ngdoc60
1 files changed, 60 insertions, 0 deletions
diff --git a/docs/cookbook.ngdoc b/docs/cookbook.ngdoc
new file mode 100644
index 00000000..7dc937c5
--- /dev/null
+++ b/docs/cookbook.ngdoc
@@ -0,0 +1,60 @@
+@workInProgress
+@ngdoc overview
+@name Cookbook
+@description
+
+Welcome to the angular cookbook. Here we will show you typical uses of angular by example.
+
+
+# Hello World
+
+{@link cookbook.helloworld Hello World}: The simplest possible application that demonstrates the
+classic Hello World!
+
+
+# Basic Form
+
+{@link cookbook.form Basic Form}: Displaying forms to the user for editing is the bread and butter
+of web applications. Angular makes forms easy through bidirectional data binding.
+
+
+# Advanced Form
+
+{@link cookbook.formadvanced Advanced Form}: Taking the form example to the next level and
+providing advanced features such as dirty detection, form reverting and submit disabling if
+validation errors exist.
+
+
+# Model View Controller
+
+{@link cookbook.mvc MVC}: Tic-Tac-Toe: Model View Controller (MVC) is a time-tested design pattern
+to separate the behavior (JavaScript controller) from the presentation (HTML view). This
+separation aids in maintainability and testability of your project.
+
+
+# Multi-page App and Deep Linking
+
+{@link cookbook.deeplinking Deep Linking}: An AJAX application never navigates away from the
+first page it loads. Instead, it changes the DOM of its single page. Eliminating full-page reloads
+is what makes AJAX apps responsive, but it creates a problem in that apps with a single URL
+prevent you from emailing links to a particular screen within your application.
+
+Deep linking tries to solve this by changing the URL anchor without reloading a page, thus
+allowing you to send links to specific screens in your app.
+
+
+# Services
+
+{@link angular.service Services}: Services are long lived objects in your applications that are
+available across controllers. A collection of useful services are pre-bundled with angular but you
+will likely add your own. Services are initialized using dependency injection, which resolves the
+order of initialization. This safeguards you from the perils of global state (a common way to
+implement long lived objects).
+
+
+# External Resources
+
+{@link cookbook.buzz Resources}: Web applications must be able to communicate with the external
+services to get and update data. Resources are the abstractions of external URLs which are
+specially tailored to angular data binding.
+