about.pod6

Author: hankache

doc/Language/about.pod6

@@ -2,7 +2,7 @@
 
 =TITLE About the Docs
 
-=SUBTITLE Documentation for the Perl 6 Documentation Project
+=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
@@ -17,19 +17,19 @@ 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>.
-This document also provides a short introduction to writing the Perl 6
-POD files, which can be rendered into HTML and other formats.
+This document also provides a short introduction to writing Perl 6
+Pod files, which can be rendered into HTML and other formats.
 
 =head1 Structure
 
-All of the documentation is written in Pod6 and kept in the C<doc/>
+All of the documentation is written in Perl 6 Pod and kept in the C<doc/>
 directory, and the C<doc/Language/> and C<doc/Type/> sub-directories.
 These files are processed as collections of definitions or
 "documentables", which are then post-processed and linked together.
 
-=head1 Generating HTML from POD
+=head1 Generating HTML from Pod
 
-To generate HTML from the POD files, you'll need:
+To generate HTML from the Pod files, you'll need:
 
 =item A recent version of the Rakudo Perl 6 compiler
 
@@ -39,7 +39,7 @@ To generate HTML from the POD files, you'll need:
 =item B<Optional>: L<GraphViz|http://graphviz.org>, for creating graphs
 of the relationships between Perl 6 types
 
-=item B<Optional>: L<Pygments|http://pygments.org>, for doing syntax
+=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:
@@ -57,6 +57,12 @@ perl app.pl daemon
 
 =head1 Contributing
 
+The documentation is written in Perl 6 Pod.
+
+For a quick introduction to Perl 6 Pod, see L<Perl 6 Pod|https://docs.perl6.org/language/pod>.
+
+For full details about the Perl 6 Pod specification, see L<Synopsis 26, Documentation|https://design.perl6.org/S26.html>.
+
 =head2 Adding definitions
 
 Documentables can be defined using an C<=headN> Pod directive, where
@@ -141,6 +147,4 @@ renders like this
 
 Notice that text after a pipe ('|') has no formatting. Also note that B<V< C<> >>
 preserves spaces and treats text as verbatim.
-
-For full details about Perl 6 POD, see L<Synopsis 26, Documentation|https://design.perl6.org/S26.html>.
 =end pod