Require Dist::Zilla 4.200016+

[gitmo/Moose.git] / lib / Moose / Manual.pod

diff --git a/lib/Moose/Manual.pod b/lib/Moose/Manual.pod
index d8a0e16..f50ca63 100644 (file)
--- a/lib/Moose/Manual.pod
+++ b/lib/Moose/Manual.pod
@@ -1,8 +1,10 @@
-=pod
+package Moose::Manual;
+
+# ABSTRACT: What is Moose, and how do I use it?
 
-=head1 NAME
+__END__
 
-Moose::Manual - What is Moose, and how do I use it?
+=pod
 
 =head1 WHAT IS MOOSE?
 
@@ -22,7 +24,7 @@ With Moose, you can concentrate on the I<logical> structure of your
 classes, focusing on "what" rather than "how". A class definition with
 Moose reads like a list of very concise English sentences.
 
-Moose is built in top of C<Class::MOP>, a meta-object protocol (aka
+Moose is built on top of C<Class::MOP>, a meta-object protocol (aka
 MOP). Using the MOP, Moose provides complete introspection for all
 Moose-using classes. This means you can ask classes about their
 attributes, parents, children, methods, etc., all using a well-defined
@@ -99,7 +101,7 @@ We'll leave the line-by-line explanation of this code to other
 documentation, but you can see how Moose reduces common OO idioms to
 simple declarative constructs.
 
-=head2 TABLE OF CONTENTS
+=head1 TABLE OF CONTENTS
 
 This manual consists of a number of documents.
 
@@ -110,6 +112,11 @@ This manual consists of a number of documents.
 Introduces Moose concepts, and contrasts them against "old school"
 Perl 5 OO.
 
+=item L<Moose::Manual::Unsweetened>
+
+Shows two example classes, each written first with Moose and then with
+"plain old Perl 5".
+
 =item L<Moose::Manual::Classes>
 
 How do you make use of Moose in your classes? Now that I'm a Moose,
@@ -123,7 +130,7 @@ features!
 
 =item L<Moose::Manual::Delegation>
 
-Delegation is a powerful way to make use of attribute which are
+Delegation is a powerful way to make use of attributes which are
 themselves objects.
 
 =item L<Moose::Manual::Construction>
@@ -156,7 +163,8 @@ children, methods, attributes, etc.
 
 =item L<Moose::Manual::MooseX>
 
-This document shows a few of the most useful Moose extensions on CPAN.
+This document describes a few of the most useful Moose extensions on
+CPAN.
 
 =item L<Moose::Manual::BestPractices>
 
@@ -164,11 +172,24 @@ Moose has a lot of features, and there's definitely more than one way
 to do it. However, we think that picking a subset of these features
 and using them consistently makes everyone's life easier.
 
+=item L<Moose::Manual::FAQ>
+
+Frequently asked questions about Moose.
+
+=item L<Moose::Manual::Contributing>
+
+Interested in hacking on Moose? Read this.
+
+=item L<Moose::Manual::Delta>
+
+This document details backwards-incompatibilities and other major
+changes to Moose.
+
 =back
 
 =head1 JUSTIFICATION
 
-If you're still still asking yourself "Why do I need this?", then this
+If you're still asking yourself "Why do I need this?", then this
 section is for you.
 
 =over 4
@@ -201,8 +222,9 @@ production with little or no issue now for years. We consider it
 highly stable and we are committed to keeping it stable.
 
 Of course, in the end, you need to make this call yourself. If you
-have any questions or concerns, please feel free to email Stevan, the
-moose@perl.org list, or just stop by irc.perl.org#moose and ask away.
+have any questions or concerns, please feel free to email Stevan or
+the moose@perl.org list, or just stop by irc.perl.org#moose and ask
+away.
 
 =item Is Moose just Perl 6 in Perl 5?
 
@@ -228,19 +250,4 @@ Nuff Said.
 
 =back
 
-=head1 AUTHORS
-
-Dave Rolsky E<lt>autarch@urth.orgE<gt>
-
-Stevan Little E<lt>stevan@iinteractive.comE<gt>
-
-=head1 COPYRIGHT AND LICENSE
-
-Copyright 2008-2009 by Infinity Interactive, Inc.
-
-L<http://www.iinteractive.com>
-
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
-
 =cut