Convert READMEs to Markdown

categories/99-problems/README.md

@@ -1,38 +1,37 @@
-99  Problems In Perl
-====================
+# 99  Problems In Perl
 
 Based on the problems from
 http://www.ic.unicamp.br/~meidanis/courses/mc336/2006s2/funcional/L-99_Ninety-Nine_Lisp_Problems.html
 (which is stored here for future use).
 
-Save solutions as PXX-author.pl as in other directories where XX is the problem
+Save solutions as `PXX-author.pl` as in other directories where XX is the problem
 number and author is the....author!
 
 Please include a specification describing the problem and, ideally, a
 description of your solution and the perl6 features that it uses.
 
 Use this as a template for your solutions:
 
-use v6;
+    use v6;
 
-# Specification:
-#   PXX (*) Problem copied from L-99_Ninety-Nine_Lisp_Problems.html
-#       You are encouraged to modify the specification to fit perl6 thinking.
-#       For example, P21 originally implied returning a copy of the list,
-#       since LISP does not have mutable lists; you may change the wording to
-#       reflect this, or change the spec to allow modification in-place.
-#
-# Example: (preferably in the form of a REPL session)
-# > say 'Hello, world!'
-# Hello, world!
+    # Specification:
+    #   PXX (*) Problem copied from L-99_Ninety-Nine_Lisp_Problems.html
+    #       You are encouraged to modify the specification to fit perl6 thinking.
+    #       For example, P21 originally implied returning a copy of the list,
+    #       since LISP does not have mutable lists; you may change the wording to
+    #       reflect this, or change the spec to allow modification in-place.
+    #
+    # Example: (preferably in the form of a REPL session)
+    # > say 'Hello, world!'
+    # Hello, world!
 
 
-# Explanation of your answer, discussion of perl6 features used
-# We create a function which returns its argument to needlessly complicate a
-# hello, world program
+    # Explanation of your answer, discussion of perl6 features used
+    # We create a function which returns its argument to needlessly complicate a
+    # hello, world program
 
-sub my_func ($x) {
-    return $x
-}
+    sub my_func ($x) {
+	return $x
+    }
 
-say my_func('Hello, world!')
+    say my_func('Hello, world!')

categories/best-of-rosettacode/README.md

@@ -1,3 +1,7 @@
+# Rosetta code
+
+http://rosettacode.org
+
 This directory contains some good examples taken from rosettacode.org. We make
 an effort to pick examples that cover some useful or novel aspect of the Perl
 6 language and share some pointers about where to get more information about

categories/cookbook/README.md

@@ -1,3 +1,5 @@
+# PLEAC: Programming Language Examples Alike Cookbook
+
 This is PLEAC, from https://github.com/pleac/pleac
 
 PLEAC stands for "Programming Language Examples Alike Cookbook."  Think "Perl6
@@ -9,7 +11,7 @@ mirror the Cookbook (2nd Edition) and to ease sorting.  Please do not use the
 1st edition section names.
 
 NOTE:
-  - This was a port from the now defunct pugs/examples/cookbook which then
-    became mu/examples/cookbook supporting Rakudo.
 
+  - This was a port from the now defunct `pugs/examples/cookbook` which then
+    became `mu/examples/cookbook` supporting Rakudo.
   - PLEAC itself doesn't seem very active

categories/euler/README.md

@@ -1,9 +1,11 @@
-Project Euler
-=============
+# Project Euler
+
 http://projecteuler.net/
 
 This is a directory to post answers to project euler questions.
 
-Use the file format prob000-author.pl, while replacing "000" with the problem number and "author" with your name.  For example if I am eric256 and I answer problem No. 1, I will save it as prob001-eric256.pl
+Use the file format `prob000-author.pl`, replacing "000" with the
+problem number and "author" with your name.  For example if I am eric256 and
+I answer problem No. 1, I will save it as `prob001-eric256.pl`.
 
 Thanks for playing!

categories/perlmonks/README.md

@@ -1,12 +1,12 @@
-Perlmonks
-=========
+# Perlmonks
+
 http://perlmonks.org
 
 These are answers to various perlmonks questions.
 
-File Naming
------------
-Please names files like "description-nodeid.pl"
+## File Naming
 
-Replacing description with a description ;) and nodeid with the node that the code is in reply to.
+Please names files like `description-nodeid.pl`
 
+Replacing description with a description ;) and nodeid with the node that
+the code is in reply to.

categories/rosalind/README.md

@@ -1,19 +1,19 @@
-Rosalind
-========
+# Rosalind
+
 http://rosalind.info/
 
 This is a directory to post solutions to Rosalind problems (Rosalind is a
 Project Euler inspired platform for teaching bioinformatics).
 
-*** SPOILER WARNING ***
-If you intend to learn bioinformatics with rosalind, you'll have
+** SPOILER WARNING **
+If you intend to learn bioinformatics with Rosalind, you'll have
 to resist the temptation of reading the solutions in this directory.
-*** YOU'VE BEEN WARNED ***
+** YOU'VE BEEN WARNED **
 
-Use the file format <id>-<author>.pl replacing <id> with the (lowercase)
-problem ID and <author> with your name.
+Use the file format `<id>-<author>.pl` replacing `<id>` with the (lowercase)
+problem ID and `<author>` with your name.
 
-For a given problem <id>, you can find its full description there:
+For a given problem `<id>`, you can find its full description there:
 
 http://rosalind.info/problems/<id>
 

categories/wsg/README.md

@@ -1,9 +1,13 @@
-Winter Scripting Games
-======================
+# Winter Scripting Games
+
 http://www.microsoft.com/technet/scriptcenter/funzone/games/default.mspx
 
-This is a directory to post solutions to the winter scripting games events. It is further divided by difficulty and year (beginner-2008, advanced-2007, etc.)
+This is a directory to post solutions to the winter scripting games events.
+It is further divided by difficulty and year (beginner-2008, advanced-2007,
+etc.)
 
-Use the file format event000-author.pl replacing 000 with the problem number and author with your name.  For example if I am eric256 and I answer problem one I will save it as event001-eric256.pl
+Use the file format `event000-author.pl` replacing 000 with the problem number
+and author with your name.  For example if I am eric256 and I answer problem
+one I will save it as `event001-eric256.pl`.
 
 Thanks for playing!

doc/README.md

@@ -1,13 +1,7 @@
-Perl 6 Examples Documentation
-=============================
+# Perl 6 Examples Documentation
 
 Documentation where possible, should be inline in the example.
 There are always other documents required. Create a sensible name,
 where possible include in the form:
 
-	DirectoryName-ProgramName.pod (.txt, .html)
-
-
-License Information
--------------------
-See ../README
+    DirectoryName-ProgramName.pod (.txt, .html)