Guide to contributing to the Center for Cooperative Research
  

Important Note: the contribution system is not yet entirely complete!

Overview
Event Submission
Event Acceptance / Rejection
Editors
Managers
Reporting Bugs

Overview

The timelines published on this website are dynamically generated from timeline entries stored in the database. Registered users can submit new timeline entries or edit existing ones.

Event Submission

Note: None of the projects are currently open for online editing

It is recommended that before you begin editing or submitting new entries that you (1) read a portion of the timeline you intend to edit in order to acquaint yourself with the writing style and general format; (2) read the writing guidelines listed below; and (3) click the “edit” link on several entries to familiarize yourself with the wiki mark-up code that is used to write entries. You can view an explanation of the special mark-up code by clicking the Syntax Guide link when you are on the edit entry page.

To add an entry, click the “add event” link at the top of the page. To edit an existing entry, click the “edit” link above the entry you would like to change. When you have finished, click the “preview” button at the bottom of the page to preview the entry. If you are happy with the final text of the entry, click submit. Your entry will appear as “pending” until an editor can review your entry. If your entry is not reviewed within 48 hours, feel free to contact us.

Event Acceptance/Rejection

After submitting a change or new entry to a timeline, your submission will appear only to you and other registered users who have permission to view and edit that timeline. The new entry or change will not be viewable to others until it has been approved by an editor. A change may be rejected if it is determined to be factually incorrect or the information is of poor quality; if the supplied sources fail to back up statements made in the entry; if the item is off-topic; or if the submission in not consistent with the site's standard style and layout. In the case that it is off-topic, the entry may simply be moved to a different timeline. You will (once the system is finished) be able to track the status of your submissions on your “home” page. If you believe that a submission has been unfairly rejected, contact us and another manager will review the submission.

An entry that is submitted to a timeline may also, instead of being rejected, be tagged a “work-in-progress” (WIP). Only registered users who have edit permissions for that timeline can view or edit WIP entries. A color-coding system is used to display the status of events to registered users—green signifies the status is accepted, orange that a submission is still pending review, and gray that the event is WIP.

Editors

Users who have demonstrated strong writing and analytical skills may be invited to become an editor. Note that whether your views happen to agree with the views of existing editors will not be an issue—on the contrary, we are hoping that the editing team will grow to include a wide range of views.

Managers

Users who would like to begin a timeline on a certain topic should send a request to us describing the proposed project. They should have at least 10 hours available each week to devote to the project and should have good writing and analytical skills. If the proposed project is approved, the user will become a manager of that project. As a manager, one may coordinate the efforts of other users contributing to the timeline, respond to emails concerning the project, and maintain the project's focus by keeping the timeline entries on topic.

Reporting bugs

If you discover any new bugs in the contribution system, please report them to bugs@cooperativeresearch.org . Please explain in as much detail as possible, where, how, and when the problem occurred. You may also send suggestions to this address.

Known bugs:

  • Sometimes, after submitting an event, you are directed back to an empty timeline.
  • The system will allow you to submit an event without a date.