This middleman project contains pages that document the Doubtfire project - a task oriented system designed to help support frequent formative feedback.

Doubtfire is an open-source, innovative, learning management system designed to put the student first.

Inside the webiste, you can find :

1. Installation guides for Doubtfire.
2. User guides.
3. Extend Doubtfire and Contributions.

Go to Website

Start by ensuring you have ruby on your system. You must install rbenv to keep your ruby versions under control. Refer to rbenv's installation guide on how to do so.

Ensure you have installed ruby version 2.4.3:

$ rbenv install 2.4.3
$ rbenv rehash

Then, install bundler to sort out your ruby dependencies:

$ gem install bundler
$ bundle install

Guides are categorised using a tag. Once you have decided for one or more tag for your guide, execute the following command:

bundle exec middleman article "[Name of Guide]" -t [tags]

Once you execute this command, you will see that the guide you have named appears under source/articles/guides using the current day’s date. For example,

source/articles/guides/20XX-XX-XX-my-guide.html.md.

##Adding Required Frontmatter Open this file in a text editor and you will see the following:

title: My Guide date: 2017-12-11 06:44 UTC tags: tag1,tag2

Note: All tags should be in lowercase. The data separated by the three dashes (---) is known as the frontmatter of the guide. This contains metadata about the guide, which (by default) includes the guide name, date created, and associated tags.

Note: You must add the following keys to the frontmatter: author: your full name, author_url: a URL to your GitHub profile or personal website, and summary: a summary of the guide that should be no more than two to three lines and should embody the gist of the guide.

##Write the guide Underneath the bottom three dashes, you may begin writing your guide using Github-flavoured Markdown. You won’t need to add the title of the guide as a Heading 1 (

Develop using:

$ bundle exec middleman serve

Your website will be watched and hosted locally at http://localhost:4567/.

Publish using:

$ rake publish

If this fails, try rebuilding the build folder from scratch then redeploy:

$ rm -rf build
$ rake publish

Doubtfire is completely open source, and free to use — any contributions to the project are appreciated!

Licensed under the MIT Licence.