Update README.md

Author: harto

README.md

@@ -1,15 +1,44 @@
-A minimal PHP client for [Thumbor][1].
+# Phumbor
 
-Usage:
-```php
-$original = 'http://images.example.com/llamas.jpg';
-$commands = array('fit-in', '640x480', 'filters:fill(green)');
+A minimal PHP client for generating [Thumbor][1] URLs.
+
+## Usage
+
+You construct a `Thumbor\Url` using a `Thumbor\Url\Builder`:
 
+```php
 $server = 'http://thumbor.example.com:1234';
 $secret = 'my-secret-key';
 
-echo new \Thumbor\Url($original, $commands, $server, $secret);
+echo Thumbor\Url\Builder::construct($server, $secret)
+    ->from('http://images.example.com/llamas.jpg')
+    ->fitIn(640, 480)
+    ->addFilter('fill', 'green');
+
 // => http://thumbor.example.com:1234/mYdVBN25gyqUGD3QRsI9_rl1IxQ=/fit-in/640x480/filters:fill(green)/http%3A%2F%2Fimages.example.com%2Fllamas.jpg
 ```
 
+To reuse your server/secret combination, create a `Thumbor\Url\BuilderFactory`:
+
+```php
+$thumbnailUrlFactory = Thumbor\Url\BuilderFactory::construct($server, $secret);
+
+echo $thumbnailUrlFactory
+    ->fromUrl('http://images.example.com/llamas.jpg')
+    ->fitIn(640, 480)
+    ->addFilter('fill', 'green');
+    
+echo $thumbnailUrlFactory
+    ->fromUrl('http://images.example.com/butts.png')
+    ->crop(20, 20, 300, 300)
+    ->valign('middle');
+    
+// etc
+```
+
+## License
+
+MIT; see [`LICENSE`][2]
+
  [1]: https://github.com/globocom/thumbor
+ [2]: https://github.com/99designs/phumbor/blob/master/LICENSE