## DMP Roadmap

DMP Roadmap is a Data Management Planning tool. It allows users to create data management plans for the projects using funder specific templates and institutional guidance. Once a plan has been completed it can be downloaded and inserted into your grant proposals.

Management and development of the 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.

#### Current Release
v.0.1.0

#### Summary

#### Pre-requisites
DMPonline is a Ruby on Rails application and you will need to have: 
1. Ruby >= 2.0.0p247
2. Rails >= 4.0
3. MySql >= 5.0

Further details 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
* Create your mysql db. Select UTF-8 Unicode (utf8mb4) encoding.
* Fork the repository and then clone it onto your server
** > git clone https://github.com/[your organization]/roadmap.git
** > cd roadmap
** > gem install bundler (if bundler is not yet installed)
** > bundle install

#### Troubleshooting
* Installation
** ``` An error occurred while installing libv8 (3.11.8.17), and Bundler cannot continue.
Make sure that `gem install libv8 -v '3.11.8.17'` succeeds before bundling. ```
*** If you are installing on a system that already has v8 installed then you may need to install the libv8 gem manually using your system's current v8 engine.
*** ``` gem install libv8 -v '3.11.8.17' -- --with-system-v8 ```

#### Support
Issues should be reported here on Github https://github.com/DMPRoadmap/roadmap/issues
Please be advised though that we can only provide limited support for your local installations.

#### Become a contributor
Fork this repository and make your modifications in a new branch. Then create a pull request to our 'development' branch. We will reject any pull request made against the 'master' branch. Once your pull request has been submitted the team will review your request and accept it if appropriate.

Join the email listserv at roadmap-l (at) listserv.ucop (dot) edu. 

#### License
The DMP Roadmap project uses to the <a href="./LICENSE.md">MIT License</a>.