An open API service indexing awesome lists of open source software.

https://github.com/centerforassessment/nciea_internship_2015

Repository for 2015 Center for Assessment (NCIEA) Internship on Reporting
https://github.com/centerforassessment/nciea_internship_2015

Last synced: about 2 months ago
JSON representation

Repository for 2015 Center for Assessment (NCIEA) Internship on Reporting

Awesome Lists containing this project

README

          

Assessment & Data Literacy
==========================

#### Enhancing assessment & data literacy using [Explorable Explanations](http://explorableexplanations.com/)

[![Join the chat at https://gitter.im/CenterForAssessment/NCIEA_Internship_2015](https://badges.gitter.im/Join%20Chat.svg)](https://gitter.im/CenterForAssessment/NCIEA_Internship_2015?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge) [![License](http://img.shields.io/badge/license-GPL%203-brightgreen.svg?style=flat)](https://github.com/CenterForAssessment/NCIEA_Internship_2015/blob/master/LICENSE.md)

### Crafted with :heart: by:

* [Gretchen Anderson](https://github.com/ganders309)
* [Damian Betebenner](https://github.com/dbetebenner)
* [Luciana Cançado](https://github.com/lcancado)
* [Charlie DePascale](https://github.com/cdepascale)

## Prerequisites

* [Install Node.js](https://nodejs.org/)
* [Install Git](https://git-scm.com/downloads)
* [Install Atom](https://atom.io/) with the following add-on packages
* [git-clone](https://atom.io/packages/git-clone)
* [git-control](https://atom.io/packages/git-control) (maybe. SourceTree is better)
* [Install SourceTree](http://www.sourcetreeapp.com/)
* Open a command prompt and run `npm install -g serve`

## Getting Started

1. Find a Gist you like. If you don't already have one, try this [simple bar chart example](https://gist.github.com/bclinkinbeard/3a65ba05a662103bb2e9).
2. Fork the Gist and copy the HTTPS clone URL to your clipboard:
![Fork and copy](https://github.com/CenterForAssessment/NCIEA_Internship_2015/raw/master/assets/fork_and_copy.gif)
3. In Atom, open the Command Palette with Cmd/Ctrl+Shift+P, or by using the View menu:
![Command palette](https://github.com/CenterForAssessment/NCIEA_Internship_2015/raw/master/assets/cmd_palette.png)
4. Type the word "clone" and select the Git Clone entry from the menu that appears:
![Clone](https://github.com/CenterForAssessment/NCIEA_Internship_2015/raw/master/assets/clone.png)
5. In the resulting input, paste in the URL you copied in step 2
![Clone](https://github.com/CenterForAssessment/NCIEA_Internship_2015/raw/master/assets/git_url.png)

You now have a copy of the Gist on your computer! Atom will open the directory that the files were saved to, and you are ready to work!

## Working with the code

> Instructions for starting up the local server go here

## Publishing your changes

When your code is at a point you are happy with, you can publish it back to GitHub for others to view and/or fork.

1. Publish your code as a new Gist (details TBD)
2. Generate and share the [bl.ocks.org](http://bl.ocks.org/) link to your code ([browser extension](https://github.com/mbostock/bl.ocks.org/blob/master/README.md))

## Some Examples

1. [Norm-referenced and Criterion-referenced Interpretation of Test Results](http://nciea-gist-viewer.herokuapp.com/40dc9aeec84eec66bf98/)

## Learning Resources

### Git

* [What is VCS?](https://www.youtube.com/watch?v=8oRjP8yj2Wo&index=1&list=PLg7s6cbtAD165JTRsXh8ofwRw0PqUnkVH)
* [What is Git?](https://www.youtube.com/watch?v=uhtzxPU7Bz0&index=2&list=PLg7s6cbtAD165JTRsXh8ofwRw0PqUnkVH)
* [Try Git](https://try.github.io/) is a great interactive tutorial

### JavaScript/D3

* [D3 Tutorials](http://alignedleft.com/tutorials/d3)