rules/: update comments

rules/pages/surah/id_redirect.rules

@@ -1,5 +1,9 @@
 #!/usr/bin/env ruby
 
+##
+# Rules for a redirect from a surah id to
+# a surah name (eg /en/1/ -> /en/al-fatihah/)
+
 1.upto(114) do |id|
   locales.each do |locale|
     compile "/html/pages/surah/id_redirect.html.erb", rep: "redirect_id/#{id}" do

rules/pages/surah/index.rules

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 
 ##
-# The surah index (available at /en, /ar, etc) and
+# Rules for the surah index available at /<locale>/,
-# its dependencies.
+# (eg /en/) and its dependencies.
 
 locales.each do |locale|
   compile "/html/pages/surah/index.html.erb", rep: "/#{locale}/surah/index" do

rules/pages/surah/random.rules

@@ -1,7 +1,8 @@
 #!/usr/bin/env ruby
 
 ##
-# Redirects to a random surah
+# Rules for a redirect from /<locale>/random/ to a
+# random surah (eg /en/random/ -> /en/al-kahf/)
 
 locales.each do |locale|
   compile "/html/pages/surah/random.html.erb", rep: "random/#{locale}" do

rules/pages/surah/redirect.rules

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 
 ##
-# Redirect from the root path to the surah index
+# Rules for a redirect from the root path to the surah
-# for a given locale (eg '/ -> /en', '/ -> /ar', etc)
+# index for a given locale (eg / -> /en/)
 
 compile "/html/pages/surah/redirect.html.erb" do
   filter(:erb)

rules/pages/surah/stream.rules

@@ -1,8 +1,8 @@
 #!/usr/bin/env ruby
 
 ##
-# Contains rules that are related to TheSurahPage.html.erb in one
+# Rules for the surah stream available at /<locale>/<name>/
-# way or another
+# (eg /ar/al-fatihah/) and its dependencies.
 
 compile "/*/*/surah.json" do
   write(item.identifier.to_s)