Added an introduction, including external-documentation now

2 files changed, 24 insertions, 25 deletions

diff --git a/skel/docs/external-documentation b/skel/docs/external-documentation
deleted file mode 100644
index d591479..0000000
--- a/skel/docs/external-documentation
+++ /dev/null
@@ -1,25 +0,0 @@
-Here are some useful links to a knowledge source not included in
-Rakudo Star, yet helpful and especially useful for beginners.
-
-* Perl 5 to 6
-  http://perlgeek.de/en/article/5-to-6
-
-Series of articles by Moritz Lenz giving an excellent introduction
-to Perl 6 for Perl 5 programmers, focusing on the changed things
-and underlining the caveats.
-
-* Perl 6 Advent Calendar
-  http://perl6advent.wordpress.com/
-
-Series of articles showing "Something cool about Perl 6 every day".
-Advent Calendar shows some nice new features of Perl 6, explains
-the new operators and shows many interesting, challenging examples
-of their usage.
-
-* Gabor Szabo's screencasts
-  http://szabgab.com/perl6.html#screencast
-
-In his screencasts, Gabor Szabo shows a baby-steps introduction
-to Perl 6, showing code examples and executing them to show their
-effect on the screen. A great introduction if you'd like to start
-from the very beginning and explore Perl 6 piece by piece.
diff --git a/skel/docs/introduction b/skel/docs/introduction
new file mode 100644
index 0000000..4b67d53
--- /dev/null
+++ b/skel/docs/introduction
@@ -0,0 +1,24 @@
+How to start using Perl 6
+=========================
+
+If you alredy know Perl 5, the "Perl 5 to 6" series of articles [1]
+aimed at people familiar with Perl 5, will show you the most
+significant changes, step by step.
+
+If You're completely new to Perl, Gabor Szabo's screencasts [2] will
+introduce you to Perl 6 from the very beginning, showing the effects
+of every example in real time.
+
+In both cases You'll probably be interested in Perl 6 Advent
+Calendar [3], showing "something cool about Perl 6 every day".
+Advent Calendar shows some nice new features of Perl 6, explains
+the new operators and shows many interesting, challenging examples
+of their usage.
+
+For a more official source of information, the formal specification
+of Perl 6 [4] is also available for reading.
+
+[1] http://perlgeek.de/en/article/5-to-6
+[2] http://szabgab.com/perl6.html#screencast
+[3] http://perl6advent.wordpress.com/
+[4] http://perlcabal.org/syn/