Skip to content

TeachTechTaskForce/edumap

Repository files navigation

EduMap

The app is up on Heroku

Minimal commands to get the app running (if you have things set up)

More system-specific setup information is on our wiki.

git clone https://github.com/andyras/edumap.git
cd edumap/edumap
gem install bundler
bundle install
rake db:create  # you may have to prepend `bundle exec` to get this to work.
rake db:migrate
rake db:seed
rails s

View the app at http://localhost:3000

Linux

Linux users will have to install and configure postgresSQL before running the above commands.

How to contribute

Everyone: play with the site!

If you see anything that you think could be improved on the site, let us know by submitting an issue (make sure you have a github account first).

Web developers: code!

There are usually a few frontend tweaks that we are working on; browse our issues list to see how you can contribute.

Data scientists / data entry experts: add curriculum!

Option 1: manual data entry Our publicly editable curriculum status sheet has a 'template' tab; duplicate this tab, give it an appropriate name, and enter information from a particular curriculum.

Option 2: scrape to .csv Some websites are organized enough (and large enough) to merit scraping the information programatically. If you have the expertise, you're welcome to scrape sites that are out there and output to .csv.

Both options: Further down in this README, there is a specification of what we are looking for as far as data about curriculum options.

Curricula

List and status

View curriculum status here

Desiderata for each curriculum

In general curricula are broken up into lessons; that is the quantum of curriculum we are working with. Most information will be one-to-one (e.g. age range), and some will be many-to-one (many standards codes map onto one lesson).

Scraping Essentials

  • Identifier for each lesson
    • The unique identifier for each lesson is the name of the curriculum plus a code for that lesson.
    • two strings with no whitespace, e.g. Code.org,1.1
  • URL for lesson
    • should be publicly visible
    • string, e.g. "https://code.org/curriculum/course1/1/Teacher"
  • Age (or grade) range for each lesson
    • string, e.g. "Ages 8-10", "Grade 4"
  • Short description for each lesson
    • string, e.g. "Happy Maps"
  • Time for lesson
    • string, e.g. "1 class period", "45 minutes"
    • If you have to guess, add "est." before the time, e.g. "est. 1 class period"
  • Platform/OS or materials
    • string, e.g. "Web", "iOS, Android", "pencil, paper, SPAM"
  • Plugged vs. Unplugged
    • string, either "Plugged" or "Unplugged"

Scraping Nice-to-haves

  • Topic area
    • string, e.g. "Loops", "Internet security"

To Deploy to Heroku

From the root directory of the app: git subtree push --prefix edumap heroku master

Standards so far

Desiderata for each standard

  • Standard name
    • string, e.g. "NGSS", "CC Math"
  • Standard code
    • string, e.g. "6.NS.8"
  • Description of student outcome
    • string, e.g. "Solve real-world and mathematical problems by graphing points in all four quadrants of the coordinate plane. Include use of coordinates and absolute value to find distances between points with the same first coordinate or the same second coordinate."

Scraping Essentials

  • Identifier for each standard item
    • The unique identifier for a standard item comprises the name of the standard plus the specific code
    • two strings, no whitespace in the code portion, e.g. "NGSS,HS-ETS1-1"
  • Description of the standard item
    • string, e.g. "Analyze a major global challenge to specify qualitative and quantitative criteria and constraints for solutions"

Scraping Nice-to-haves

  • Hierarchy
    • Each standard has a hierarchy, e.g. the Common Core Math has Standards > Clusters > Domains
    • This would be an .md file giving a brief breakdown of how the standard is structured (useful if we decide to someday have filtering by intermediate areas of each standards hierarchy)

Mappings

A mapping is a set of connections between a lesson and standards codes.

CSV Format

  • The format is the lesson identifier followed by the standard item identifier
    • e.g. "Code.org,1.1,ISTE,1.c"

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Contributors 20