--- trunk/lib/Frey.pm	2008/08/31 18:02:50	180
+++ trunk/lib/Frey.pm	2008/11/05 19:13:01	308
@@ -1,7 +1,7 @@
 package Frey;
 use Moose;
 
-our $VERSION = "0.15";
+our $VERSION = "0.18";
 
 has 'debug' => (
 	is => 'rw',
@@ -23,6 +23,38 @@
 Basically you write L<Moose> classes which become deirectly callable from
 the web using REST API
 
+=head1 INTROSPECTION
+
+Secondary goal is to have introspection.
+
+=head2 Moose classes
+
+All Moose classes have simple introspection API which use
+L<Frey::Introspect> to show class and it's pod (using L<Frey::Pod>). 
+
+Example of valid REST URL is
+
+  http://localhost:16001/Frey
+
+which will show L<Frey> class introspection.
+
+You can also add method invocation and optonal parametars to C<new>
+constructor like this:
+
+  http://localhost:16001/Frey::Pod/markup?class=Frey
+
+this is same using L<Frey::Pod> from perl as
+
+  Frey::Pod->new( class => 'Frey' )->markup;
+
+if you leave out parametars, L<Frey::Run> will ask for required ones.
+
+=head2 Database
+
+For database objects we support L<Fey> and when your objects are created
+C<< with 'Frey::Collection' >> they will have basic CRUD functionality
+implemented by L<Frey::ObjectBrowser>.
+
 =cut
 
 1;