more config notes

Author: tamouse

_config.yml

@@ -1,5 +1,9 @@
-# These are things you should customize for your class
+# You *MUST* change these two items:
 title: Your Awesome Class
+baseurl: "/jekyll-reveal-starter-kit"
+# ^ This is the path of the slide set below the site URL.
+
+# These are things you should customize for your class
 author: Your Name
 description: |
   Your awesome class in all it's glory.
@@ -18,19 +22,6 @@ contact:
   twitter: "gdimpls"
   github: "gdiminneapolis"
 
-# This is the path of the slide set below
-# the site URL. For development purposes,
-# the site URL is empty, but when the
-# site is published, it should have the
-# actual URL. The published URL should
-# be set in _publish_config.yml, and
-# when the publish step is done, include
-# both configurations like so:
-#
-#   jekyll build --config=_config.yml,_config_publish.yml
-#
-# Further info can be found in the README file.
-baseurl: "/jekyll-reveal-starter-kit"
 
 # There are a handful of styles available with reveal. They can be found in the
 # reveal.js/css/themes folder, and include:

_config_publish.yml

@@ -1,13 +1,18 @@
-# Put configuration items needed exclusively for publishing
+# Put configuration items needed exclusively for publishing in this file.
 #
 # When performing the Jekyll build for publishing, include this file:
 #
 #   jekyll build --config=_config.yml,_config_publish.yml
 #
 
-
 # The URL portion is what is substituted in site.url
 # in the slides. By default, use the GDIMpls Github Pages
 # prefix, and the baseurl setting in _config.yml
 # for the repository name.
 url: "https://gdiminneapolis.github.io"
+
+# If you fork something from the GDIMpls repo into your own repo, and
+# use the same publish to Github track, your version will be availble
+# at the url "https://<yourgithub>.github.io/<repo-name/". This could
+# generate some confusion when contributing to the GDIMpls
+# repo. **BEWARE**