Update documentations to Meteor 0.9.0

Author: Urigo

README.md

@@ -1,23 +1,23 @@
-ngMeteor v0.2
+ngMeteor
 ========
-> The simplest no-conflict way to use AngularJS with Meteor, Meteorite and Atmosphere Smart Packages.
+> The simplest no-conflict way to use AngularJS with Meteor.
 
 > ngMeteor v0.1.22+ works with Blaze.
+> ngMeteor v0.2.0+ works with Meteor 0.8.2, 0.8.3, 0.9.0 and above.
 
 ## Quick start
 1. Install [Meteor](http://docs.meteor.com/#quickstart) <code>curl https://install.meteor.com | /bin/sh</code>
-2. Install [Meteorite](https://github.com/oortcloud/meteorite#installing-meteorite) <code>npm install -g meteorite</code>
-3. Create a new meteor app using <code>meteor create myapp</code> or navigate to the root of your existing app.
-4. Install ngMeteor <code>mrt add ngMeteor</code>
+2. Create a new meteor app using <code>meteor create myapp</code> or navigate to the root of your existing app.
+4. Install urigo:ngmeteor <code>meteor add urigo:ngmeteor</code>
 
 ## Usage
 ### Table of Contents
-- [New Data-Binding to avoid conflict](https://github.com/loneleeandroo/ngMeteor#new-data-binding-to-avoid-conflict)
-- [Using Meteor Collections](https://github.com/loneleeandroo/ngMeteor#using-meteor-collections)
-- [Adding controllers, directives, filters and services](https://github.com/loneleeandroo/ngMeteor#adding-controllers-directives-filters-and-services)
-- [Creating and inserting template views](https://github.com/loneleeandroo/ngMeteor#creating-and-inserting-template-views)
-- [Routing](https://github.com/loneleeandroo/ngMeteor#routing)
-- [Module Injection](https://github.com/loneleeandroo/ngMeteor#module-injection)
+- [New Data-Binding to avoid conflict](https://github.com/urigo/ngmeteor#new-data-binding-to-avoid-conflict)
+- [Using Meteor Collections](https://github.com/urigo/ngmeteor#using-meteor-collections)
+- [Adding controllers, directives, filters and services](https://github.com/urigo/ngmeteor#adding-controllers-directives-filters-and-services)
+- [Creating and inserting template views](https://github.com/urigo/ngmeteor#creating-and-inserting-template-views)
+- [Routing](https://github.com/urigo/ngmeteor#routing)
+- [Module Injection](https://github.com/urigo/ngmeteor#module-injection)
 
 ### New Data-Binding to avoid conflict
 To prevent conflicts with Meteor's Blaze live templating engine, ngMeteor has changed the default AngularJS data bindings from <code>{{...}}</code> to <code>[[...]]</code>. For example:
@@ -30,7 +30,6 @@ To prevent conflicts with Meteor's Blaze live templating engine, ngMeteor has ch
     </div>
 
 ### Using Meteor Collections
-> If you're upgrading from v0.1 please read this section for changes on using the $collection service.
 
 ngMeteor provides an AngularJS service called $collection, which is a wrapper for [Meteor collections](http://docs.meteor.com/#meteor_collection) to enable reactivity within AngularJS. The $collection service no longer subscribes to a publisher function automatically, so you must explicitly subscribe to a publisher function before calling the $collection service.
 
@@ -130,8 +129,89 @@ For example:
         });
 
     }
+
+
+### Adding controllers, directives, filters and services
+It is best practice to not use globally defined controllers like they do in the AngularJS demos. Always use the exported package scope ngMeteor as your angular module to register your controller with $controllerProvider. Furthermore, to prevent errors when minifying and obfuscating the controllers, directives, filters or services, you need to use [Dependency Injection](http://docs.angularjs.org/guide/di). For example:
+
+    ngMeteor.controller('TodoCtrl', ['$scope', '$collection',
+      function($scope, $collection) {
+        $collection("todos", $scope);
+       
+        $scope.addTodo = function() {
+          $scope.todos.add({text:$scope.todoText, done:false});
+          $scope.todoText = '';
+        };
+
+        $scope.saveTodo = function(){
+          $scope.todos.add($scope.todos);
+        }
+       
+        $scope.remaining = function() {
+          var count = 0;
+          angular.forEach($scope.todos, function(todo) {
+            count += todo.done ? 0 : 1;
+          });
+          return count;
+        };
+       
+        $scope.archive = function() {
+          angular.forEach($scope.todos, function(todo) {
+            if (todo.done) $scope.todos.delete(todo);
+          });
+        };
+      }
+    ]);
+
+### Creating and inserting template views
+A template is defined using the template tags (this could be in a standalone file or included in another file).
+
+    <template name="foo">
+      <h1>Hello, World!</h1>
+    </template>
+
+You can render this template using handlebars as you would for any other Meteor app:
+
+    {{> foo}}
+
+Templates will also be added to the $templateCache of the ngMeteor angular module. To invoke the template in AngularJS you could use ng-view and specify the template in the $templateCache when defining your routes using the $routeProvider or your could use the ng-template directive to render your template like this:
+
+    <ANY ng-template="foo"></ANY>
+
+    <!--Add the ng-controller attribute if you want to load a controller at the same time.-->    
+    <ANY ng-template="foo" ng-controller="fooCtrl"></ANY>
+    
+Templates with names starting with an underscore, for example "_foo", will not be put into the $templateCache, so you will not be able to access those templates using ng-template, ng-include or ng-view.
+
+### Routing
+The [ngRoute](http://docs.angularjs.org/api/ngRoute) module developed by the AngularJS team is included in ngMeteor, which will satisfy those with simple routing needs. For example, if you want to call a template called 'foo' and a controller called 'TodoCtrl' when someone lands on your home page you would define your route like this:
+
+    ngMeteor.config(['$routeProvider', '$locationProvider',
+      function($routeProvider, $locationProvider) {
+        $routeProvider.when('/',{
+          templateUrl: 'foo',
+          controller: 'TodoCtrl'
+        });
+          
+        $locationProvider.html5Mode(true);
+      }
+    ]);
+
+For larger applications with more completed routes, it would be wise to consider using the [urigo:angular-ui-router](https://github.com/Urigo/meteor-angular-ui-router) Meteor package for ngMeteor, which exposes the popular [ui-router](https://github.com/angular-ui/ui-router) module to ngMeteor. For those of you that have grown accustomed to the Meteor methods of routing, ngMeteor is compatible with [Iron Router](https://github.com/EventedMind/iron-router).
+    
+### Module Injection
+If you have a module called myModule, for example:
+
+    myModule = angular.module('myModule',[]);
+
+it can be easily injected into ngMeteor like this:
+
+    ngMeteor.requires.push('myModule');
 
-We've also updated the meteor-angular-ui-router to support Meteor 0.8.3:
+Using this method, additional functionality has been provided to urigo:ngmeteor in the form of separate Meteor packages that expose and inject angular modules into ngMeteor. These packages have been developed by either the ngMeteor Team and/or by third parties. The following is a non-exhaustive list of these packages:
+
+- [urigo:angular-ui-router](https://github.com/Urigo/meteor-angular-ui-router) empowers ngMeteor with the [ui-router](https://github.com/angular-ui/ui-router) module.
 
-- [angular-ui-router](https://github.com/Urigo/meteor-angular-ui-router) empowers ngMeteor with the [ui-router](https://github.com/angular-ui/ui-router) module.
+Feel free to make ngMeteor module smart packages, and please contact [urigo](https://github.com/urigo) if you would like your package to be listed here as well.
+Be sure to be compatible with Meteor 0.9.0 and above and it's packaging system!