--- trunk/lib/Frey.pm	2008/11/01 00:14:05	223
+++ trunk/lib/Frey.pm	2008/12/04 23:09:52	723
@@ -1,11 +1,17 @@
 package Frey;
 use Moose;
 
-our $VERSION = "0.17";
+our $VERSION = "0.23";
+
+use Data::Dump qw//;
+sub dump {
+	my ($self,$data) = @_;
+	Data::Dump::dump( $data );
+}
 
 has 'debug' => (
 	is => 'rw',
-	isa => 'Bool',
+	isa => 'Int',
 	default => 0,
 );
 
@@ -15,24 +21,60 @@
 
 =head1 DESCRIPTION
 
-n. Mythology.
+  n. Mythology.
 
-The Norse god who dispenses peace, good weather, prosperity, and bountiful
-crops; the brother of Freya.
+  The Norse god who dispenses peace, good weather, prosperity, and bountiful
+  crops; the brother of Freya.
 
 Basically you write L<Moose> classes which become deirectly callable from
-the web using REST API
+the Firefox using REST API. for gentle intoduction see L<Frey::Manual>.
+
+This is just brief overview of concepts so you might check if they suite you
+before you get into details.
+
+=head1 Developer parts
+
+=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:
 
-=head1 INTROSPECTION
+  http://localhost:16001/Frey::Pod/as_markup?class=Frey
 
-Secondary goal is to have introspection.
+this is same using L<Frey::Pod> from perl as
+
+  Frey::Pod->new( class => 'Frey' )->as_markup;
+
+Forms to enter required parameters will be generated automatically, 
+allowing you to explore your data while you are making interface for it.
 
 =head2 Database
 
+FIXME broken if not noted in C<TODO>
+
 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>.
 
+=head1 User parts
+
+=head2 Pipes
+
+See L<Frey::Pipe> for now.
+
+=head1 SEE ALSO
+
+L<Frey::Manual>
+
 =cut
 
 1;