--- trunk/lib/Frey.pm	2008/11/01 00:14:05	223
+++ trunk/lib/Frey.pm	2008/11/05 08:21:04	293
@@ -27,6 +27,28 @@
 
 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