Author: brianleroux
Date: Fri Jul 19 15:33:24 2013
New Revision: 1504918
URL: http://svn.apache.org/r1504918
Log:
the ol switchero
Modified:
cordova/site/www/_posts/2013-07-08-cordova-has-a-blog.md
cordova/site/www/_posts/2013-07-19-cordova-3.md
Modified: cordova/site/www/_posts/2013-07-08-cordova-has-a-blog.md
URL:
http://svn.apache.org/viewvc/cordova/site/www/_posts/2013-07-08-cordova-has-a-blog.md?rev=1504918&r1=1504917&r2=1504918&view=diff
==============================================================================
--- cordova/site/www/_posts/2013-07-08-cordova-has-a-blog.md (original)
+++ cordova/site/www/_posts/2013-07-08-cordova-has-a-blog.md Fri Jul 19
15:33:24 2013
@@ -1,78 +1,16 @@
---
layout: post
author:
- name: Brian LeRoux
- url: https://twitter.com/brianleroux
-title: "Apache Cordova 3.0"
-date: 2013-07-19 15:45:04 -5
-categories: blog releases
-published: false
-tags: news releases MAJOR
+ name: Carlos Santana
+ url: https://twitter.com/csantanapr
+title: "Apache Cordova Gets an Official Blog"
+date: 2013-07-11 15:45:04 -5
+categories: blog
+tags: news
---
-# Cordova 3.0 Released
+Cordova now has a Blog! Look here to stay up-to-date with what's happening
with the project.
+There is a major release
[3.0](https://issues.apache.org/jira/browse/CB/fixforversion/12322491)
+just around the corner (July 19, 2013), and we are really excited about it!
-Snapshot available on our [download
page](https://www.apache.org/dist/cordova/) but before downloading please read
on to find out whats new including for more ways to work with Cordova!
-
-## Light Weight Core
-
-Cordova 3 introduces a new unified project structure and ships with a very
limited API surface. Developers can now compose a version of Cordova with only
the APIs they need. In the past, Cordova shipped with the entire kitchen sink
of APIs that most applicaitons only needed a small subset of. This lead to
messy, and often not even neccessary, upgrading for our community. With the
release of Cordova 3 you start with a very light weight core and only add the
API surface your application requires. Obviously, this means a performance
improvement but the real win here is maintainance and upgrading. We'll continue
to maintain "core" APIs which are the same device APIs you've come to know and
love.
-
-## New Command Line Tooling
-
-We're very excited to share two new command line tools: Cordova and Plugman.
Both are implemented using `NodeJS` and thusly distributed via `npm`. The
`cordova` command line tool has been a long time coming. It unifies all
platforms into a single project structure which enables us to extend with
futher tooling around plugins. This is where `plugman` fits in, allowing for
automated discovery, installation, and removal of core and custom plugins.
-
-We've been testing for months but keep in mind both tools are new, and bugs
happen, so you if you find one or even just have an idea for a new feature
please visit our [issue tracker](http://issues.cordova.io).
-
-## Installing > Downloading
-
-First, [ensure you have NodeJS installed](http://nodejs.org) and then simply
run `npm install -g cordova`. From here its a typical comand line utility. Get
started by building an iOS app!
-
-```
-$ cordova create MyFunkyApp
-$ cd MyFunkyApp
-$ cordova platform add ios
-$ cordova emulate ios
-```
-
-Cordova lazy loads so the first app you create might be a little slow. Same
with platform adds. Just use `-d` flag to see progress. For example, `cordova
-d platform add ios`. Maybe crack a beer and chill while it goes about its
business first run.
-
-Now lets add Android, `cordova platform add android`. Yes: that easy!
-
-# Installing Plugins
-
-If you are working with a `cordova` generated project then you can install
using it. (Plugman is included in the Cordova install.)
-
-```
-$ cd MyFunkyApp
-$ cordova plugin add
https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
-```
-You now have geolocation enabled your project!
-
-If you are working with a native project directly then `plugman` can be used
standalone. Again, [ensure you have NodeJS installed](http://nodejs.org) and
then simply run `npm install -g plugman`.
-
-```
-$ cd MyAndroidProject
-$ plugman --platform android --project . --plugin
https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
-
-```
-
-Of course, you can create your own plugins! (And we're really excited to see
what you do.) You can learn how to author a plugin by [reading the
spec](https://github.com/apache/cordova-plugman/blob/master/plugin_spec.md). We
are going to be writing much more documentation about this in the future. In
the meantime, you can learn a great deal looking at the [core
plugins](https://git-wip-us.apache.org/repos/asf?s=cordova-plugin).
-
-# Upgrading
-
-We have documented [upgrading
guides](http://cordova.apache.org/docs/en/2.9.0/guide_upgrading_index.md.html)
to help with the transition. Of course, do not hesitate to come for help in
#cordova irc channel on freenode, or just visit our [issue
tracker](http://issues.cordova.io).
-
-# Known Issues
-
-Remember *core plugins no longer exist by default in new projects* and you
have to manually add them using `plugman`. You know we release regularily so
you can expect updates soon and we're going to leave a nice big window for
deprecations as usual.
-
-- <merges> to change soon in plugin spec
-- whitelist format will be unified soon, but isn't yet
-- various native IDE's show generated files
-- no way to upgrade existing CLI projects
-- plugin discovery
-
-# Huge Thanks
-
-Thank you to all the committers, testers, developers, and friends of Cordova
whom made this possible!
+Be sure to [subscribe]({{ site.baseurl }}{{ site.rss_path }}) using RSS
Modified: cordova/site/www/_posts/2013-07-19-cordova-3.md
URL:
http://svn.apache.org/viewvc/cordova/site/www/_posts/2013-07-19-cordova-3.md?rev=1504918&r1=1504917&r2=1504918&view=diff
==============================================================================
--- cordova/site/www/_posts/2013-07-19-cordova-3.md (original)
+++ cordova/site/www/_posts/2013-07-19-cordova-3.md Fri Jul 19 15:33:24 2013
@@ -1,17 +1,78 @@
---
layout: post
author:
- name: Carlos Santana
- url: https://twitter.com/csantanapr
-title: "Apache Cordova Gets an Official Blog"
-date: 2013-07-11 15:45:04 -5
-categories: blog
-tags: news
+ name: Brian LeRoux
+ url: https://twitter.com/brianleroux
+title: "Apache Cordova 3.0"
+date: 2013-07-19 15:45:04 -5
+categories: blog releases
+published: false
+tags: news releases MAJOR
---
-Cordova now has a Blog! Look here to stay up-to-date with what's happening
with the project.
-There is a major release
[3.0](https://issues.apache.org/jira/browse/CB/fixforversion/12322491)
-just around the corner (July 19, 2013), and we are really excited about it!
+# Cordova 3.0 Released
-Be sure to [subscribe]({{ site.baseurl }}{{ site.rss_path }}) using RSS
+Snapshot available on our [download
page](https://www.apache.org/dist/cordova/) but before downloading please read
on to find out whats new including for more ways to work with Cordova!
+## Light Weight Core
+
+Cordova 3 introduces a new unified project structure and ships with a very
limited API surface. Developers can now compose a version of Cordova with only
the APIs they need. In the past, Cordova shipped with the entire kitchen sink
of APIs that most applicaitons only needed a small subset of. This lead to
messy, and often not even neccessary, upgrading for our community. With the
release of Cordova 3 you start with a very light weight core and only add the
API surface your application requires. Obviously, this means a performance
improvement but the real win here is maintainance and upgrading. We'll continue
to maintain "core" APIs which are the same device APIs you've come to know and
love.
+
+## New Command Line Tooling
+
+We're very excited to share two new command line tools: Cordova and Plugman.
Both are implemented using `NodeJS` and thusly distributed via `npm`. The
`cordova` command line tool has been a long time coming. It unifies all
platforms into a single project structure which enables us to extend with
futher tooling around plugins. This is where `plugman` fits in, allowing for
automated discovery, installation, and removal of core and custom plugins.
+
+We've been testing for months but keep in mind both tools are new, and bugs
happen, so you if you find one or even just have an idea for a new feature
please visit our [issue tracker](http://issues.cordova.io).
+
+## Installing > Downloading
+
+First, [ensure you have NodeJS installed](http://nodejs.org) and then simply
run `npm install -g cordova`. From here its a typical comand line utility. Get
started by building an iOS app!
+
+```
+$ cordova create MyFunkyApp
+$ cd MyFunkyApp
+$ cordova platform add ios
+$ cordova emulate ios
+```
+
+Cordova lazy loads so the first app you create might be a little slow. Same
with platform adds. Just use `-d` flag to see progress. For example, `cordova
-d platform add ios`. Maybe crack a beer and chill while it goes about its
business first run.
+
+Now lets add Android, `cordova platform add android`. Yes: that easy!
+
+# Installing Plugins
+
+If you are working with a `cordova` generated project, then you can install
plugins using the `cordova` tool as well: `plugman` is included with `cordova`,
and is used by `cordova` internally to manage plugins.
+
+```
+$ cd MyFunkyApp
+$ cordova plugin add
https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
+```
+You now have geolocation enabled your project!
+
+If you are working with a native project directly then `plugman` can be used
standalone. Again, [ensure you have NodeJS installed](http://nodejs.org) and
then simply run `npm install -g plugman`.
+
+```
+$ cd MyAndroidProject
+$ plugman --platform android --project . --plugin
https://git-wip-us.apache.org/repos/asf/cordova-plugin-geolocation.git
+
+```
+
+Of course, you can create your own plugins! (And we're really excited to see
what you do.) You can learn how to author a plugin by [reading the
spec](https://github.com/apache/cordova-plugman/blob/master/plugin_spec.md). We
are going to be writing much more documentation about this in the future. In
the meantime, you can learn a great deal looking at the [core
plugins](https://git-wip-us.apache.org/repos/asf?s=cordova-plugin).
+
+# Upgrading
+
+We have documented [upgrading
guides](http://cordova.apache.org/docs/en/2.9.0/guide_upgrading_index.md.html)
to help with the transition. Of course, do not hesitate to come for help in
#cordova irc channel on freenode, or just visit our [issue
tracker](http://issues.cordova.io).
+
+# Known Issues
+
+Remember *core plugins no longer exist by default in new projects* and you
have to manually add them using `plugman`. You know we release regularly so you
can expect updates soon and we're going to leave a nice big window for
deprecations as usual.
+
+- <merges> to change soon in plugin spec
+- whitelist format will be unified soon, but isn't yet
+- various native IDE's show generated files
+- no way to upgrade CLI projects from the beta releases of the CLI (<=2.9)
+- a plugin discovery repository is still being baked and will be available
very soon
+
+# Huge Thanks
+
+Thank you to all the committers, testers, developers, and friends of Cordova
whom made this possible!
