Permalink
Browse files

Merge branch 'ayardley/parrot_github_release'

  • Loading branch information...
2 parents 7f7caad + e68d18a commit 876221012b5c983f9b1fa7c16279770676882667 @ayardley ayardley committed Apr 5, 2012
View
@@ -1,7 +1,11 @@
2012-04-17 release 4.3.0
- Core
+ Winxed snapshot updated to 375562d
+ + New 'tools/release/parrot_github_release.pl' script to automate
+ updates to the 'parrot.github.com' and 'parrot-docsx' repositories.
- Documentation
+ + Updated 'docs/projects/release_manager_guide.pod'
+ + Updated 'docs/projects/release_parrot_github_guide.pod'
- Tests
- Community
View
@@ -2202,6 +2202,7 @@ tools/release/crow.pir []
tools/release/cut.pl []
tools/release/gen_release_info.pl []
tools/release/inc_ver.pir []
+tools/release/parrot_github_release.pl []
tools/release/release.json []
tools/release/releasecheck.pl []
tools/release/sha256sum.pl []
@@ -454,9 +454,18 @@ Preview the new page, and submit it.
The old release announcement may be edited to uncheck I<Promoted to front page>
to keep the main page fresh.
-=head2 X. Update parrot.github.com and any Relevant parrot-docsx Repositories
+=head2 X. Update parrot.github.com and the Relevant parrot-docsx Repository
-Please read and follow the instructions in
+To update both the C<parrot.github.com> and the relevant C<parrot-docsx> repositories,
+execute the following command:
+
+ perl tools/release/parrot_github_release.pl
+
+Please note: To review the available options, use the C<-h | --help> option.
+In addition, you may also want to review the pod with,
+C<perldoc tools/release/parrot_github_release.pl>.
+
+For more information about the update process, I<see>
L<http://github.com/parrot/parrot/blob/master/docs/project/release_parrot_github_guide.pod>.
=head2 XI. Publicity
@@ -15,7 +15,12 @@ I<see> '/docs/project/release_manager_guide.pod', laying out how to publish
Parrot's documentation to the 'parrot.github.com' repository and how to
archive the previous release of Parrot's documentation in the gh-pages branch
of the supporting parrot-docx' repositories. While none of this is particularly
-difficult, it is a'bit tricky; hence, this guide.[1]
+difficult, it is a'bit tricky; hence, this guide.
+
+Please note: The auto-tool, F<tools/release/parrot_github_release.pl> has,
+largely, superceded the functionality contained within this document.[1]
+I<See> F<docs/projects/release_manager_guide.pod> I<and>
+F<tools/release/parrot_github_release.pl>.
=head2 Assumptions
@@ -185,7 +190,7 @@ and F<releases.html>, back to 'parrot.github.com'.
=back
-Now, you need to hand-edit both F<index.html> and F<releases.html>.[5] Open
+Now, you need to hand-edit both F<index.html> and F<releases.html>. Open
F<index.html> in your favorite editor and update the header and footer to
reflect the present release version. That is, edit, for example, the line
@@ -293,26 +298,21 @@ If everything works correctly, congratulations, you're done with both the
=head1 FOOTNOTES
-[1] Hopefully, soon, we will develop a script to handle most, if not all, of
-the steps outlined in this guide. At which time we will either re-write this
-guide or eliminate it entirely.
+[1] For the present, we have elected to retain this document, primarily, for
+historical purposes and as a reference document for future release managers.
[2] If you are working with a release of Parrot's documentation greater than
v4.x.x and you do not have, for example, a 'parrot-docs5' repository, you will
-need to contact an "owner" and ask them to create a new repository. You will,
-then, need to follow all of the steps outlined in Github's gh-pages guide at
-'http://pages.github.com/' to set up the repository.
+need to contact an "owner" and ask him or her to create a new repository. You
+will, then, need to follow all of the steps outlined in Github's gh-pages guide
+at 'http://pages.github.com/' to set up the repository.
-[3] You do NOT need to worry with any optimizations when configuring Parrot
-because you only need the previous documentation release.
+[3] Here, you do NOT need to worry with any optimizations when configuring
+Parrot because you only need the previous documentation release.
[4] Unless there is good reason to do otherwise, please name the newly created
directory after the F<VERSION> of the Parrot distribution you are archiving in
-the repo. Here, in our guide example, C<4.0.0>.
-
-[5] This next handful of steps screams out for an auto-tool, and we will write
-one soon. (But, for now, you will have to settle for the detail steps in this
-guide.)
+the repo. Here, in our example, C<4.0.0>.
=head1 COPYRIGHT
Oops, something went wrong.

0 comments on commit 8762210

Please sign in to comment.