pconrad/awesomeprelims

Preliminary work for the Awesome library (A Discrete Math Library, but not DisMaL).

AwesomePrelims

Preliminary work for the Awesome library (not DisMaL).

No more individual dirs... just js and java

Useful JavaScript References (for non-beginners that want to become advanced practitioners)

Best:

• JavaScript Enlightenment, By: Cody Lindley, Publisher: O'Reilly Media, Inc., Pub. Date: January 7, 2013, Print ISBN-13: 978-1-4493-4288-3 ** http://proquest.safaribooksonline.com/book/programming/javascript/9781449344412 ** Off campus: http://proquest.safaribooksonline.com.proxy.library.ucsb.edu:2048/book/programming/javascript/9781449344412

Perhaps Also helpful:

• Maintainable JavaScript, By: Nicholas C. Zakas, O'Reilly Media, Inc., 2012, ISBN-13: 978-1-4493-2768-2 ** http://proquest.safaribooksonline.com/book/programming/javascript/9781449328092
• JavaScript Web Applications, By: Alex MacCaw, O'Reilly Media, Inc, 2011, ISBN-13: 978-1-4493-0351-8 ** http://proquest.safaribooksonline.com/book/programming/javascript/9781449308216

(From off campus, just stick .proxy.library.ucsb.edu:2048 after the safaribooksonline.com part of the URL.)

Getting Started

This section is for new contributors to the AwesomePrelims repo. It assumes some basic familiarity with git and github concepts.

The two branches

The master branch is, as usual, the... um... master branch. So, what is that other branch, gh-pages?

That's the branch that actually gets published to the web at pconrad.github.io/AwesomePrelims

So, the usual workflow is:

• do the "real" work in the master branch.
• Let's suppose that you did a git clone, and now, a clone of this repo is in /home/jsmith/github/AwesomePrellims on your local hard drive. Check your work by visiting the URL file:///home/jsmith/github/AwesomePrelims/index.html
• You may commit and push often to the master branch. But, then, when and only when you have something stable that you want to share with the world, as the official new "release" of AwesomePrelims, you do:

NOTE: WHAT I WROTE BELOW MAY BE TOTAL NONSENSE... I'M GOING TO TRY IT OUT...

git checkout gh-pages   # switch to gh-pages branch
git merge origin master   # go get that stuff from master and stick it in the current gh-pages branch
git push origin gh-pages
git checkout master

awesomeprelims's Issues

Add method to return pair of correct answer index, and list of n possible answers to multipleChoiceQuestion.js

If performance is ever an issue for generating symmetricTransReflexive problems, refactor for precomutped sets

Create a set for each property, symmetric, transitive, and reflexive for sets of size 2, 3 and 4, using a 4, 9 or 16 bit number to represent which subset of the cartesian product is used.

From there, we can generate a relation with any of the properties by using set intersect, and difference. This could be faster.

Add the View HTML, View Pretty HTML and View LaTeX buttons to all the DeadWeekQuizzes, without resorting to copy/paste

that is, factor out the common code as much as possible.

Incorporate jsdoc3 into our project workflow

Investigate https://github.com/jsdoc3/jsdoc#readme and figure out how to install, use and automate.

(by automate, I'm anticipating that we might use a script or some kind, or since it appears to be Java based, maybe an ant build.xml file.)

new question type--correct or incorrect digit in base

True false: numeral could exist in base specified.

E.g. 247 base 8. True

989 base 8 false

On the set operations quiz, sometimes questions repeat.

That's not good! (Reported by Sarah D. and Ian V.)

Invetigate Randomness, and having a way to input a seed for reproducibility

Redesign setOperations problem generation for greater variety.

Code that generates the setOps1 quiz has p where div is more appropriate

The generated HTML for setOps1.html generates:

 <p id="quizzes">

 ...

 </p>

 <p id="answers">

 ...

 </p>

Change both of these to <div> tags. And, add a closing comment, like this:

 <div id="quizzes">

 </div> <!-- id="quizzes" -->

Investigate Driving exam from a Google Spreadsheet

Investigate the possibility of allowing users to specify parameters for a particular practice quiz, or exam, via a Google Spreadsheet.

The spreadsheet could contain information about the mix of question types, parameters for the questions, etc.

Once jsdoc3 is figured out, add jsdoc3 comments into all our js code, starting with set.js

Small JS library to implement shift, & and ^ on sequences of 64 bits.