diff --git a/docs/guide/intro-yii.md b/docs/guide/intro-yii.md index 41c1e4aa15..bbe1e3512c 100644 --- a/docs/guide/intro-yii.md +++ b/docs/guide/intro-yii.md @@ -10,7 +10,7 @@ What is Yii Best for? --------------------- Yii is a generic Web programming framework, meaning that it can be used for developing all kinds -of Web applications based on PHP. Because of its component-based architecture and sophisticated caching +of Web applications using PHP. Because of its component-based architecture and sophisticated caching support, it is especially suitable for developing large-scale applications such as portals, forums, content management systems (CMS), e-commerce projects, RESTful Web services, and so on. @@ -18,20 +18,22 @@ management systems (CMS), e-commerce projects, RESTful Web services, and so on. How does Yii Compare with Other Frameworks? ------------------------------------------- +If you're already familiar with another framework, you may appreciate knowing how Yii compares: + - Like most PHP frameworks, Yii implements the MVC (Model-View-Controller) design pattern and promotes code - organization based on this pattern. -- Yii takes the philosophy that code should be written in a simple yet elegant way. It will never try to - over-design things mainly for the purpose of following some design pattern. -- Yii is a full-stack framework providing many proven and ready-to-use features, such as: query builders - and ActiveRecord, for both relational and NoSQL databases; RESTful API development support; multi-tier + organization based on that pattern. +- Yii takes the philosophy that code should be written in a simple yet elegant way. Yii will never try to + over-design things mainly for the purpose of strictly following some design pattern. +- Yii is a full-stack framework providing many proven and ready-to-use features: query builders + and ActiveRecord for both relational and NoSQL databases; RESTful API development support; multi-tier caching support; and more. -- Yii is extremely extensible. You can customize or replace nearly every piece of core code. You can also - take advantage of its solid extension architecture, to use or develop redistributable extensions. +- Yii is extremely extensible. You can customize or replace nearly every piece of the core's code. You can also + take advantage of Yii's solid extension architecture to use or develop redistributable extensions. - High performance is always a primary goal of Yii. -Yii is not a one-man show, it is backed up by a [strong core developer team][] as well as a large community -with many professionals constantly contributing to the development of Yii. The Yii developer team -keeps a close eye on the latest trends of Web development, and on the best practices and features +Yii is not a one-man show, it is backed up by a [strong core developer team][], as well as a large community +of professionals constantly contributing to Yii's development. The Yii developer team +keeps a close eye on the latest Web development trends and on the best practices and features found in other frameworks and projects. The most relevant best practices and features found elsewhere are regularly incorporated into the core framework and exposed via simple and elegant interfaces. @@ -41,8 +43,8 @@ Yii Versions ------------ Yii currently has two major versions available: 1.1 and 2.0. Version 1.1 is the old generation and is now in maintenance mode. Version 2.0 is a complete rewrite of Yii, adopting the latest -technologies and protocols, including Composer, PSR, namespaces, traits, and so forth. Version 2.0 represents the latest -generation of the framework and will receive our main development efforts in the next few years. +technologies and protocols, including Composer, PSR, namespaces, traits, and so forth. Version 2.0 represents the current +generation of the framework and will receive the main development efforts over the next few years. This guide is mainly about version 2.0. @@ -52,7 +54,7 @@ Requirements and Prerequisites Yii 2.0 requires PHP 5.4.0 or above. You can find more detailed requirements for individual features by running the requirement checker included in every Yii release. -Using Yii requires basic knowledge about object-oriented programming (OOP), as Yii is a pure OOP-based framework. +Using Yii requires basic knowledge of object-oriented programming (OOP), as Yii is a pure OOP-based framework. Yii 2.0 also makes use of the latest features of PHP, such as [namespaces](http://www.php.net/manual/en/language.namespaces.php) and [traits](http://www.php.net/manual/en/language.oop5.traits.php). Understanding these concepts will help you more easily pick up Yii 2.0.