Creative Commons

Screencast Overview

How To Contribute to the Map

For People Who Don't Want to Fuss Much With GitHub

Not everybody wants to deal with forking and pulling nor editing HTML (but see below if you do), so we have set up a way for you to add your ideas via the project's GitHub Issues . All you need to know how to do is type in a web form, much like a blog comment.

To participate, though, you will need a GitHub account...

(1) Create and/or login to a GitHub Account

You can create one at http://github.com/

(2) Explore the Core / Master Module Map

Clicking the modules on the top tabs will open its set of Performance Objectives:
Master Map

Clicking any objective's title will reveal its current information
e-objs

This includes:

  • An introductory paragraph that explains the objective (this is open to suggestions for wording).
  • A list of enabling objectives, e.g. more specific elements.
  • OERs that could be used to teach the objective (we are asking for more suggestions)
  • Ideas for activities to be done to demonstrate mastery of the objective as well as suggestions for how to assess completion of the objective.

Add your ideas by clicking the icon for adding a suggestion

Click the pencil icon comment to open the GitHub Issue entry form... it opens with a template offering places for you to edit/add ideas for this objective:
Master Map

You can add to any of the three areas (or remove ones you are not referring to:

  • Suggestions for the introductory paragraph
  • Title, URL, provider name, and license for any OERs that could be used to understand/explain the objective.
  • Ideas for activities that could be assessed to demonstrate the objective. Please be as detailed as possible, and keep in mind that the activity must be assessable.

Repeat. And repeat often!

How To Directly Edit Maps

For Those Who "Get" GitHub

If GitHub does not invoke fear but excitement, we welcome you too. We left the option open for you to edit directly in the project.

(1) Create and/or login to a GitHub Account

You can create one at http://github.com/

(2) Request to be added as a collaborator to the project

... by sending a request as an issue (delete the default template content)

Or, if you prefer, at the point of editing, you can create your own branch, and submit edits as a pull request.

(3) Explore the Core / Master Module Map

Clicking the modules on the top tabs will open its set of Performance Objectives:
Master Map

Clicking the grey wrench icon mod will open the source of this objective in GitHub
e-objs

(4) Editing an Objective in GitHub

As viewed in GitHub you will see the HTML code for this objective. Click the pencil/edit icon. Note: If you are asked to "fork" the repository first, this means you have not been added yet as a collaborator from step 2. Please wait or contact us! Or fork away
edit-github

Now you should be able to edit the content in HTML. The three parts we ask you to edit are:

  • The description of the objective; a few sentences that introduce it.
  • Hypertext links to suggested Creative Commons licensed OERs that could be used to understand the objective. Please included the name of the source site in parentheses.
  • Ideas for activities that could be assessed to demonstrate the objective.

When done editing, scroll to the bottom. Use the form field under Commit Changes to provide a brief summary of the change; this helps others get a sense of the updates happening on the site. Then click Commit Changes

(5) Review Edits

Return to the Module Map, and reload in your browser-- it might take ~1-2 minutes to show the changes.
edit-published

Your updates should be reflected in the Objective you were editing.

Repeat. And repeat often

Explore Map Draft 2.0 (spreadsheet) Participant Profiles Exisiting Resources