BlueJay89 First Flight .yaml added

.gitignore

@@ -1,3 +1,6 @@
+*~
 peerevals/
 grades/
 howtoopenshift-hfoss.txt
+hfossenv/
+*.patch

README.md

@@ -1,106 +1,17 @@
-hfoss
-==========
+# hfoss
 
-[![test status](https://api.travis-ci.org/decause/hfoss.svg)](https://travis-ci.org/decause/hfoss)
+This is the content repository for the [RIT](https://rit.edu) [Department of Interactive Games and Media](http://igm.rit.edu)
+__Humanitarian Free/Open Source Software Course__ (HFOSS). This course is a pre-requisite for advanced courses in [Free and Open Source Software at RIT](https://www.rit.edu/gccis/igm/free-open-source-software-foss-mn) [(see also)](http://www.rit.edu/news/story.php?id=50590).
 
-This is the content repository for the <a target="_blank"
-href="http://rit.edu">RIT</a> <a target="_blank"
-href="http://igm.rit.edu">Department of Interactive Games and Media</a>
-Humanitarian Free/Open Source Software Course. This course is a
-<strong>required</strong> course that is part of the RIT <a target="_blank"
-href="http://www.rit.edu/news/story.php?id=50590">Academic Minor</a> in
-Free/Open Source Software and FreeCulture (a first at any University in the
-United States!) It contains course specific static content, and should be used
-in conjunction with the <a target="_blank"
-href="http://github.com/FOSSRIT/ofCourse">ofCourse</a> courseware, distributed
-at <a target="_blank"
-href="https://pypi.python.org/pypi/ofcourse">https://pypi.python.org/pypi/ofcourse</a>
+The directory [ofcourse-content](ofcourse-content) contains that subset of course-specific content served by an
+instance of the [ofCourse](http://github.com/FOSSRIT/ofCourse) courseware, distributed
+and maintained separately at [https://pypi.python.org/pypi/ofcourse](https://pypi.python.org/pypi/ofcourse).
 
-INSTALLATION
-============
+The [assets](assets) directory contains local copies of **open educational resources** ([Creative Commons](https://wiki.creativecommons.org/wiki/What_is_OER%3F), [Wikipedia](https://en.wikipedia.org/wiki/Open_educational_resources),
+[opensource.com](https://opensource.com/education/13/4/guide-open-source-education)) either used directly by the course or useful as references or for further
+reading. It also includes binary objects (pictures, video) used in the course (eg, the course wiki).
 
-Start by forking the repository on Github. Point your browser to
-http://github.com/decause/hfoss and then click the "Fork" button in the
-top right corner of the page.
+The [docs](docs) directory may eventually contain course content (possibly
+originating from the course wiki) served via [Github Pages](https://pages.github.com/) or
+another, similar static content hosting system. 
 
-Setting up your environment
----------------------------
-
-Before you can do anything with this (run the webserver locally, or any of the
-scripts) you'll need to setup and activate a python <a target="_blank"
-href="http://pypi.python.org/pypi/virtualenv">virtualenv</a>.  Run the
-following at the command prompt...
-
-On Linux/Mac OS X
------------------
-
-If you don't have virtualenv installed yet, try::
-
- <code>$ sudo easy_install virtualenv virtualenvwrapper</code>
-
-If you're using a distro like Fedora or Ubuntu, you should try this instead::
-
- Fedora:
- <code>$ sudo yum install python-virtualenv</code>
-
- Ubuntu/Debian:
- <code>$ sudo apt-get install python-virtualenv</code>
-
-Once you have virtualenv installed, you will install be able to run::
-
- <code>$ cd code</code>
-
- <code>$ git clone git@github.com:YOUR_USERNAME/hfoss.git</code>
-
- <code>$ virtualenv --no-site-packages -p python2 hfossenv</code>
-
- <code>$ . hfossenv/bin/activate</code>
-
-On Windows
-----------
-
-At the windows command prompt::
-
- <code>$ virtualenv --no-site-packages -p python2 hfossenv</code>
-
- <code>$ hfossenv/Scripts/activate.bat</code>
-
-In msysGit or git-bash::
-
- <code>$ git clone git@github.com:YOUR_USERNAME/hfoss.git</code>
-
-Back in the windows command prompt::
-
- <code>$ cd hfoss</code>
-
-
-Installing Ofcourse
--------------------
-
-Once you've forked the repo, and activated your virual environment, you can pip
-install the courseware that serves up the content of the course. Simply run::
-
- <code>$ pip install ofcourse</code>
-
-
-Running Ofcourse
-----------------
-
-Once you've pip installed Ofcourse, you can then type::
-
- <code>$ ofcourse run</code>
-
-Which should run the courseware at <a target="_blank" href="http://127.0.0.1:5000">http://127.0.0.1:5000</a>
-
-
-LICENSES
-========
-
-Unless otherwise noted, <em>original</em> lectures and course materials created
-by the Instructor within this repository are licensed <a target="_blank"
-href="https://creativecommons.org/licenses/by-sa/4.0/">Creative Commons
-Attribution-Share Alike 4.0 International</a>.
-
-Unless otherwise noted, original source code created by the Instructor within
-this repository is licensed <a target="_blank"
-href="https://www.apache.org/licenses/LICENSE-2.0">Apache 2.0.</a>