add hints in render scripts

Author: DannyBen

lib/bashly/libraries/render/mandoc/render.rb

@@ -1,4 +1,14 @@
 # render script - mandoc
+#
+# You may set the environment variable PREVIEW to the full command you wich 
+# to preview while generating. For example:
+#
+#   PREVIEW="cli download" bashly render :mandoc docs --watch
+#
+# Alternatively, view any of the man pages with man:
+#
+#   man docs/cli.1
+#
 
 # Load the GTX template
 template = "#{source}/mandoc.gtx"

lib/bashly/libraries/render/markdown/render.rb

@@ -1,4 +1,11 @@
 # render script - markdown
+#
+# In order to preview your markdown files, you can use the madness markdown
+# server <https://madness.dannyb.co/>:
+#
+#   $ gem install madness
+#   $ madness server docs
+#
 
 # Load the GTX template
 template = "#{source}/markdown.gtx"