Proofread several documents

Changes include minor rewording, text reflow, replacing indented code samples
with =code directives-wrapped code samples, etc.

Author: uzluisf

doc/Language/about.pod6

@@ -4,18 +4,20 @@
 
 =SUBTITLE Meta-documentation
 
-This document collection represents the on-going effort to document the Perl 6 programming
-language with the goals of being: comprehensive; easy to use; easy to
-navigate; and useful to both newcomers and experienced Perl 6
-programmers.
+This document collection represents the on-going effort to document the
+Perl 6 programming language with the goals of being: comprehensive,
+easy to use, easy to navigate, and useful to both newcomers and experienced
+Perl 6 programmers.
 
 An HTML version of the documentation is located online at
 L<https://docs.perl6.org>.
 
-The official source for this documentation is located at L<perl6/doc on GitHub|https://github.com/perl6/doc>.
+The official source for this documentation is located at
+L<perl6/doc on GitHub|https://github.com/perl6/doc>.
 
 This particular document is a quick overview of the process
-described in more detail in L<CONTRIBUTING on GitHub|https://github.com/perl6/doc/blob/master/CONTRIBUTING.md>.
+described in more detail in
+L<CONTRIBUTING on GitHub|https://github.com/perl6/doc/blob/master/CONTRIBUTING.md>.
 This document also provides a short introduction to writing Perl 6
 Pod files, which can be rendered into HTML and other formats.
 
@@ -33,13 +35,15 @@ To generate HTML from the Pod files, you'll need:
 =item A recent version of the Rakudo Perl 6 compiler
 
 =item The Perl 6 modules Pod::To::HTML, Pod::To::BigPage, and URI::Escape
-(can be installed via L<zef|https://github.com/ugexe/zef>).
+which all can be installed via L<zef|https://github.com/ugexe/zef>. For
+instance, C<zef install Pod::To::HTML> to install Pod::To::HTML.
 
 =item B<Optional>: L<GraphViz|https://www.graphviz.org>, for creating graphs
-of the relationships between Perl 6 types
+of the relationships between Perl 6 types.
 
-=item B<Optional>: L<Atom Highlights|https://github.com/atom/highlights> and L<language-perl6|https://atom.io/packages/language-perl6>, for syntax
-highlighting
+=item B<Optional>: L<Atom Highlights|https://github.com/atom/highlights> and
+L<language-perl6|https://atom.io/packages/language-perl6>, for syntax
+highlighting.
 
 To generate the documentation into the C<html/> folder, run:
 
@@ -76,7 +80,9 @@ documentable. So, in:
 
 Some paragraphs, followed by some code:
 
-    my Code $examples = "amazing";
+=begin code
+my Code $examples = "amazing";
+=end code
 
 Mind === blown.
 
@@ -96,7 +102,8 @@ Documentables may contain other documentables. Class documentables, for
 example, often contain the methods the class implements.
 
 Definitions must be in one of the following forms to be recognized as
-the start of a documentable named, say, þ.  First the code in the document source:
+the start of a documentable named, say, þ.  First the code in the document
+source:
 
 =begin code
 
@@ -133,8 +140,9 @@ is always considered a definition)
 These items should now be searchable by using the search field in the HTML docs.
 
 You can add emphasis with bold (B<V< B<> >>) or italicized (B<V< I<> >>),
-with or without code formatting (B<V< C<> >>).  Due to current parser limitations,
-special steps have to be taken to use B<V< X<> >> with other formatting codes; for example:
+with or without code formatting (B<V< C<> >>). Due to current parser
+limitations, special steps have to be taken to use B<V< X<> >> with other
+formatting codes; for example:
 
 =begin code :lang<pod6>
 =item X<B<foo>|foo> a fancy subroutine
@@ -144,8 +152,8 @@ renders like this
 
 =item X<B<foo>|foo> a fancy subroutine
 
-Notice that text after a pipe ('|') has no formatting. Also note that B<V< C<> >>
-preserves spaces and treats text as verbatim.
+Notice that text after a pipe ('|') has no formatting. Also note that
+B<V< C<> >> preserves spaces and treats text as verbatim.
 =end pod
 
 # vim: expandtab softtabstop=4 shiftwidth=4 ft=perl6

doc/Language/community.pod6

@@ -12,8 +12,17 @@ of Perl and of the community." - Larry Wall
 =head1 The Perl 6 community
 
 There is a large presence on the C<#perl6> channel on C<freenode.net>,
-who are happy to provide support and answer questions. More resources can be found in the L<perl6.org community page|https://perl6.org/community/>. L<Camelia|https://perl6.org/>, the multi-color butterfly with P 6 in her wings, is the symbol of this diverse and welcoming community. We use extensively
-the L<C<#perl6>|https://perl6.org/community/irc> IRC channel for communication, questions and simply hanging out. Check out this L<IRC lingo|http://www.ircbeginner.com/ircinfo/abbreviations.html> resource for the abbreviations frequently used there.  L<StackOverflow|https://stackoverflow.com/questions/tagged/perl6> is also a great resource for asking questions and helping others with their Perl 6 problems and challenges.
+who are happy to provide support and answer questions. More resources can be
+found in the L<perl6.org community page|https://perl6.org/community/>.
+L<Camelia|https://perl6.org/>, the multi-color butterfly with P 6 in her
+wings, is the symbol of this diverse and welcoming community. We use
+extensively the L<C<#perl6>|https://perl6.org/community/irc> IRC channel for
+communication, questions and simply hanging out. Check out this
+L<IRC lingo|http://www.ircbeginner.com/ircinfo/abbreviations.html> resource
+for the abbreviations frequently used there.
+L<StackOverflow|https://stackoverflow.com/questions/tagged/perl6> is also a
+great resource for asking questions and helping others with their Perl 6
+problems and challenges.
 
 =head1 Perl 6 Weekly
 
@@ -24,7 +33,13 @@ resource to know what is going on in the Perl community now.
 
 =head1 Perl 6 Advent calendar
 
-The Perl 6 community publishes every December an L<Advent Calendar|https://perl6advent.wordpress.com/>, with Perl 6 tutorials every day until Christmas. Organization and assignment of days is done through the different Perl 6 channels and the L<Perl6/advent|https://github.com/perl6/advent> repository. If you want to participate, it starts organization by the end of October, so check out the channels above for that.
+The Perl 6 community publishes every December an
+L<Advent Calendar|https://perl6advent.wordpress.com/>, with Perl 6 tutorials
+every day until Christmas. Organization and assignment of days is done through
+the different Perl 6 channels and the
+L<Perl6/advent|https://github.com/perl6/advent> repository. If you want to
+participate, its organization starts by the end of October, so check out
+the channels above to keep up to date.
 
 =end pod