fixed readme

README.md

-Yii 2.0 Public Preview
-======================
+Yii PHP Framework Version 2
+===========================
 
-Thank you for choosing Yii - a high-performance component-based PHP framework.
+Thank you for choosing Yii 2 - a modern PHP framework designed for professional Web development.
 
-If you are looking for a production-ready PHP framework, please use
-[Yii v1.1](https://github.com/yiisoft/yii).
+Yii 2 is a complete rewrite of its previous version Yii 1.1 which is one of the most popular PHP frameworks.
+Yii 2 inherits the main spirit behind Yii for being simple, fast and highly extensible.
+Yii 2 requires PHP 5.4 and embraces best practices and protocols found in modern Web application development.
+
+
+**Yii 2 is not ready for production use yet.** We may make significant changes without prior notices.
+We expect to make the first stable release of Yii 2 in early 2014.
+
+If you mainly want to learn Yii with no real project development requirement, we highly recommend
+you start with Yii 2 as it will be our main focus for the next few years.
+
+If you have a real project with tight schedule, you should stick to [Yii 1.1](https://github.com/yiisoft/yii)
+which is the latest stable release of Yii.
 
-Yii 2.0 is still under heavy development. We may make significant changes
-without prior notices. **Yii 2.0 is not ready for production use yet.**
 
 [![Latest Stable Version](https://poser.pugx.org/yiisoft/yii2/v/stable.png)](https://packagist.org/packages/yiisoft/yii2)
 [![Total Downloads](https://poser.pugx.org/yiisoft/yii2/downloads.png)](https://packagist.org/packages/yiisoft/yii2)
@@ -18,15 +27,14 @@ without prior notices. **Yii 2.0 is not ready for production use yet.**
 DIRECTORY STRUCTURE
 -------------------
 
-      apps/                ready-to-use Web apps built on Yii 2
-          advanced/        advanced app template with complex features
-          basic/           a simple app supporting user login and contact page
-          benchmark/       app demonstrating the minimal overhead introduced by the framework
+      apps/                ready-to-use application templates
+          advanced/        a template suitable for building sophisticated Web applications
+          basic/           a template suitable for building simple Web applications
+          benchmark/       an application demonstrating the performance of Yii
       build/               internally used build tools
       docs/                documentation
       extensions/          extensions
-      framework/           framework files
-          yii/             framework source files
+      framework/           core framework code
       tests/               tests of the core framework code
 
 
@@ -39,11 +47,11 @@ The minimum requirement by Yii is that your Web server supports PHP 5.4.
 DOCUMENTATION
 -------------
 
+A draft of the [Definitive Guide](docs/guide/index.md) is available.
+
 For 1.1 users, you may refer to [Upgrading from Yii 1.1](docs/guide/upgrade-from-v1.md)
 to have a general idea of what has changed in 2.0.
 
-[Definitive Guide draft](docs/guide/index.md) is available. It's not complete yet but main parts are already OK.
-
 
 HOW TO PARTICIPATE
 ------------------

extensions/sphinx/README.md

-Yii 2.0 Public Preview - Sphinx Extension
-=========================================
+Sphinx Extension for Yii 2
+==========================
 
-Thank you for choosing Yii - a high-performance component-based PHP framework.
-
-If you are looking for a production-ready PHP framework, please use
-[Yii v1.1](https://github.com/yiisoft/yii).
-
-Yii 2.0 is still under heavy development. We may make significant changes
-without prior notices. **Yii 2.0 is not ready for production use yet.**
-
-[![Build Status](https://secure.travis-ci.org/yiisoft/yii2.png)](http://travis-ci.org/yiisoft/yii2)
-
-This is the yii2-sphinx extension.
+This extension adds [Sphinx](http://sphinxsearch.com/docs) full text search engine extension for the Yii 2 framework.
 
 
 Installation
@@ -20,26 +10,26 @@ Installation
 The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
 
 Either run
+
 ```
 php composer.phar require yiisoft/yii2-sphinx "*"
 ```
 
 or add
-```
+
+```json
 "yiisoft/yii2-sphinx": "*"
 ```
-to the require section of your composer.json.
-
 
-*Note: You might have to run `php composer.phar selfupdate`*
+to the require section of your composer.json.
 
 
 Usage & Documentation
 ---------------------
 
-This extension adds [Sphinx](http://sphinxsearch.com/docs) full text search engine extension for the Yii framework.
-This extension interact with Sphinx search daemon using MySQL protocol and [SphinxQL](http://sphinxsearch.com/docs/current.html#sphinxql) query language.
+This extension interacts with Sphinx search daemon using MySQL protocol and [SphinxQL](http://sphinxsearch.com/docs/current.html#sphinxql) query language.
 In order to setup Sphinx "searchd" to support MySQL protocol following configuration should be added:
+
 ```
 searchd
 {

framework/README.md

-Yii 2.0 Public Preview
-======================
+Yii PHP Framework Version 2
+===========================
 
-Thank you for choosing Yii - a high-performance component-based PHP framework.
+This is the core framework code of [Yii 2](https://github.com/yiisoft/yii2).
 
-If you are looking for a production-ready PHP framework, please use
-[Yii v1.1](https://github.com/yiisoft/yii).
 
-Yii 2.0 is still under heavy development. We may make significant changes
-without prior notices. **Yii 2.0 is not ready for production use yet.**
-
-[![Build Status](https://secure.travis-ci.org/yiisoft/yii2.png)](http://travis-ci.org/yiisoft/yii2)
+Installation
+------------
 
+The preferred way to install this extension is through [composer](http://getcomposer.org/download/).
 
+Either run
 
-REQUIREMENTS
-------------
+```
+php composer.phar require yiisoft/yii2-framework "*"
+```
 
-The minimum requirement by Yii is that your Web server supports PHP 5.4.0.
+or add
 
+```json
+"yiisoft/yii2-framework": "*"
+```
 
+to the require section of your composer.json.