README FluentInterface

FluentInterface/README.md

@@ -0,0 +1,11 @@
+# Fluent Interface
+
+## Purpose
+
+To write code that is easy readable just like sentences in a natural language (like English).
+
+## Examples
+
+* Doctrine2's QueryBuilder works something like that example class below
+* PHPUnit uses fluent interfaces to build mock objects
+* Yii Framework: CDbCommand and CActiveRecord use this pattern, too

FluentInterface/SQL.php

@@ -3,15 +3,7 @@
 namespace DesignPatterns\FluentInterface;
 
 /**
- * fluent interface pattern
+ * class SQL
- *
- * Purpose:
- * to write code that is easy readable just like "real" sentences
- *
- * Examples:
- * - Doctrine2's QueryBuilder works something like that example class below
- * - PHPUnit uses fluent interfaces to build mock objects
- * - Yii Framework: CDbCommand and CActiveRecord use this pattern, too
  */
 class SQL
 {