orionsprint / roadmap

DCC/UC3 collaboration for a data management planning tool

DMP Roadmap

DMP Roadmap is a Data Management Planning tool. Management and development of DMP Roadmap is jointly provided by the Digital Curation Centre (DCC), http://www.dcc.ac.uk/, and the University of California Curation Center (UC3), http://www.cdlib.org/services/uc3/.

The tool has four main functions:

1. To help create and maintain different versions of Data Management Plans;
2. To provide useful guidance on data management issues and how to meet research funders' requirements;
3. To export attractive and useful plans in a variety of formats;
4. To allow collaborative work when creating Data Management Plans.

Click here for the latest releases.

Pre-requisites

Roadmap is a Ruby on Rails application and you will need to have:

• Ruby = 2.4.0 - 2.4.4
• Rails = 4.2
• MySQL >= 5.0 OR PostgreSQL

Further detail on how to install Ruby on Rails applications are available from the Ruby on Rails site: http://rubyonrails.org.

Further details on how to install MySQL and create your first user and database. Be sure to follow the instructions for your particular environment.

• Install: http://dev.mysql.com/downloads/mysql/
• Create a user: http://dev.mysql.com/doc/refman/5.7/en/create-user.html
• Create the database: http://dev.mysql.com/doc/refman/5.7/en/creating-database.html

You may also find the following resources handy:

• The Getting Started Guide: http://guides.rubyonrails.org/getting_started.html
• Ruby on Rails Tutorial Book: http://www.railstutorial.org/

Installation

See the Installation Guide on the Wiki.

Troubleshooting

See the Troubleshooting Guide on the Wiki.

Support

Issues should be reported here on Github Issues Please be advised though that we can only provide limited support for your local installations. Any security patches and bugfixes will be applied to the most recent version, and we will endeavour to support migrations to the current release.

Contributing

If you would like to contribute to the project. Please follow these steps to submit a contribution:

• Comment on the Github issue (or create one if one does not exist) and let us know that you're working on it.
• Fork the project (if you have not already) or rebase your fork so that it is up to date with the current repository's 'development' branch
• Create a new branch in your fork. This will ensure that you are able to work at your own pace and continue to pull in any updates made to this project.
• Make your changes in the new branch
• When you have finished your work, make sure that your version of the 'development' branch is still up to date with this project. Then merge your new branch into your 'development' branch.
• Then create a new Pull Request (PR) from your branch to this project's 'development' branch in GitHub
• The project team will then review your PR and communicate with you to convey any additional changes that would ensure that your work adheres to our guidelines.

See the Contribution Guide on the Wiki for more details.

License

The DMP Roadmap project uses the MIT License.

foobar