Release notes: Translations and more

We’re back to a two-week sprint rhythm and have some exciting new things in the latest release:

  • Translations: Our collaborators at the Portage Network in Canada helped internationalize the new version of the platform and various others contributed translations of DMPonline prior to the launch. We’ve added many new features to the DMP Roadmap codebase since then. It also took some wrangling to establish a process for handling and updating translation files. We’re happy to report that the DMPTool now offers a Brazilian Portuguese translation, with additional languages in the works (Spanish, Catalán, French, German, Japanese…). Users can adjust language selections for a given session in the dropdown menu at the upper right. You can also save a default language selection for your account under Edit profile. Please note that all DMPTool templates for US funders are available in English only at the moment.

language selector dropdown

  • Request feedback emails: We made some adjustments to these based on feedback from admins. Now a participating organization must provide a primary contact email on the Organization details page in order to enable the Request feedback functionality. When a user submits a plan for feedback, the system will deliver an email notification to this primary contact email (not to everyone with admin privileges at that org as it did previously). We plan to continue refining this functionality during future sprints so please let us know what does and doesn’t work for you.
  • Guidance: Admins will notice a slight change here; you are now required to apply exactly one theme to each piece of guidance (using the radio buttons). For organizations that have guidance tagged with multiple themes, the guidance will still work and show for the existing themes. However, when you edit or update the guidance you will only see one of the themes selected and will only be able to select one from this point forward.

guidance page with theme radio buttons

  • Bug fixes and usability improvements: We’re ironing out some kinks with table sorting and searching during this latest sprint and continuing into the next one. Read the full release notes for a complete list of bug fixes and many thanks to our international user community for reporting most of these issues!

In other news

Please join me for a deep dive webinar into Themes, Templates, and Guidance on 18 July, 9-10 am PDT. Register here. The recording will be available afterward.

DMPTool promo materials are in the mail! If you want some new, blue postcards and stickers and didn’t already place your order, follow this link. And thanks to all those who provided suggestions in the order form about how we can help you help researchers create DMPs. We’ll do our best to follow up on them!

dmptool postcard

Release notes: Templates and more

The Roadmap development team just finished a huge chunk of work that we rolled out to DMPTool users this week. Prior to launching the new version of the tool we focused on optimizing the primary user side: creating DMPs. With this new release, we’ve made significant improvements to the administrative side, specifically to overhaul the way admins create and version templates.

In the midst of this major refactoring effort, we did some additional maintenance, upgrades, and accepted the first new feature contribution from our French partners at DMP OPIDoR (many thanks to Benjamin and Quentin!). The full release notes are available on GitHub. Most of the magic takes place behind the scenes, but keep reading for a summary of changes that affect the user interface.

  • Templates: You’ll notice some subtle changes as you create, edit, and update templates and customizations for funder templates. Previously, any changes you made to a template would trigger a new version. Now you can make changes to template details (Title, Description, update broken links) without versioning. Any structural changes, such as adding a new question or example answer or adding customized guidance to a funder template will create a new version. In the main templates table you will see a red editing icon (screenshot below) if you’ve made changes that created a new version. The icon includes a tooltip that alerts you to publish your changes (in the Actions menu) in order to make them available to users. You can always “Unpublish” templates and customizations at any time. You will only see the option to “Remove” (i.e. from the table/from view)  a template that has not been used to create any plans (e.g. test templates) or a customization that has not been previously published. Detailed instructions are available in the Help for Administrators.

publish changes

  • Global notifications: Super Admins (me) now have the ability to create global notifications that will be displayed to all users. These appear at the top of the screen and alert users to important news items such as scheduled maintenance or updates to funder templates. Users can dismiss the notifications by clicking the ‘x’ on the right (if I configure them to be dismissable; there may be cases where you cannot dismiss the notification but I don’t anticipate using this frequently).

global notifications

We appreciate the feedback we’ve received so far and encourage everyone to keep it coming. Specifically, let us know what additional improvements we can make to the templates and guidance areas as you test the newly released code. A note: many have reported issues with searching and sorting tables, which we’re addressing as part of the next sprint. Please report any new feedback via Github Issues or the helpdesk.

Upcoming events

  • With this latest release, the timing is finally right for a templates and guidance webinar. We’re aiming for a date in early July (TBD very soon). The recording will be available afterward.
  • For those who ordered outreach materials, you will receive them in the next 2-3 weeks. Thanks for your patience!

 

Set the controls for the heart of the sun

Our DMPTool and DMPonline services have been humming along with the same underlying code for a couple of months now. Since our MVP release, we’ve shifted gears to more regular sprints. We’re also pleasantly surprised by how eager the wider DMP community has been to join forces in migrating, translating, and even contributing new features already! Here’s a brief retrospective and a glimpse into the future.

Post MVP Backlog
There is a modest backlog of work that didn’t make into the MVP release. We’ve prioritized these issues and are focused on tying up the loose ends over the coming months. Those following the DMPRoadmap Github repository will notice regular releases. The goal is to settle into a steady two-week rhythm, but in the near term we’re working on slightly shorter or longer cycles to address critical bugs and some minor refactoring. Many thanks to our users on both sides of the pond who have reported issues and provided overwhelmingly positive feedback so far!

Evolving processes
We’ve been communicating with our respective user communities about new fixes and features as things pertain to them. Some things to note about our evolving development process:

  • DMPRoadmap GitHub repo: this is where most development work happens since the majority of fixes and features apply to the core codebase. This repository also contains all technical documentation, release notes, and other info for those interested in deploying their own instances or contributing to the project.
  • The DMPRoadmap wiki has a list of potential future enhancements. We’re collating ideas here and will define priorities and requirements in consultation with the community via user groups and listserv discussions. If you have other desired new features please let us know.
  • Any service-specific customizations reside in separate GitHub repos. For example, you can find the custom Single-Sign-On code in the DMPTool GitHub repo. The way that we handle helpdesk functions varies too. DMPTool users can report issues directly in the DMPTool repo or via the helpdesk. If something pertains to the common codebase, Stephanie will tag the issue and transfer it to DMPRoadmap. For DMPonline users we ask you to report issues via the helpdesk.

External contributions
Our core dev team is test driving the external contributor guidelines with the French team from DMP OPIDoR. They developed a new feature for a global notification system (e.g., to display maintenance messages, updates to funder templates) that happens to be in our backlog. The new feature looks great and is exactly the kind of contribution we’d like from others. You’ll see it in the next release. Thanks Benjamin and Quentin!

We’re also keen to commence monthly community dev calls to learn about other new features that folks might be planning and keep track of how we collaborate on DMP support across the globe.

Translations
We’ll be adding new translations for Brazilian Portuguese (thanks to Benilton de Sá Carvalho and colleagues at UNICAMP) and Finnish thanks to DMPTuuli. We’re also reaching out to fill in missing portions of existing translations for other languages since we added so many new features. New translations are always welcome; more information is available on the GitHub wiki and/or contact us.

A machine-actionable future
With the launch milestone behind us, we’re devoting more attention and resources to creating a machine-actionable future for DMPs. Two working groups hosted productive sessions at the recent RDA plenary (DMP Common Standards, Exposing DMPs) that included lightning talk presentations by members of the DMPRoadmap project (slides 1 and slides 2). Both of the groups are on track to provide actionable outputs in the next 12 months that will bolster wider community efforts on this front. We’ll continue participating in both groups as well as begin prototyping things with the NSF EAGER grant awarded to the California Digital Library. Stay tuned for more details via future updates and check out the activedmps.org site to get involved.

Templates and guidance 101

We’ve been running the new DMPTool for about a month now and are gratified by the positive reception from all corners of the globe. Now that we’re settling into a regular development rhythm and tying up some loose ends, I want to circle back to the topic of templates and guidance for organizational administrators.

DMPTool data migration adverse effects

As I mentioned in a recent message to the admin listserv, you may notice some misplaced organizational guidance as a result of migrating data from the old version to the new data model. Some pieces of guidance (e.g. text, links, example answers) that were created by an organizational admin and attached to specific templates (e.g. NIH Genomic Data Sharing) became divorced from the template and now appear in the list of generic themed guidance. This resulted in some cases where users now see e.g., information about NIH genomic data repositories as part of their local/organizational guidance regardless of the template they selected.

UIUC misplaced guidance

Note the DOE guidance links are “Unpublished.” These should be transferred to the DOE templates as customizations.

We’ve evaluated the extent of the problem, which can’t be solved programmatically (alas!)—there are about 30 published (active) organizational templates owned by various universities and about 40 universities who created pieces of guidance for specific funder templates that may no longer be attached to the appropriate template. We’re asking for your assistance to implement the following solution:

  1. Please take a look at your organizational Guidance in the Admin menu (screenshot above) and identify anything that seems out of place.
  2. If you can determine which template a particular piece of guidance should be attached to, you should transfer it to the appropriate question(s) for the appropriate template in the Templates menu by creating a “customization” (instructions in the Help for administrators > Customizing funder templates).
  3. After you create the customization, go back to the Guidance area and remove that piece of guidance. Alternatively, you can just unpublish the pieces of guidance that should not appear as generic guidance on all templates (instructions for Creating guidance).
  4. If you can’t easily determine where any misplaced guidance should go, contact us and we can assist you. Please just be patient with turn around times as *we* are a team of two with many other duties to juggle.
DMPTool Templates menu

Templates menu: this is where admins can create your own institutional templates or customize funder templates.

Create themed guidance

This is also a great time to familiarize yourself with the new concept of themes and apply them to your organizational guidance. Themes represent the most common topics addressed in data management plans and work like tags to associate questions and guidance. Questions within templates can be tagged with one or more themes, and guidance can be written by theme to allow organizations to apply their advice over multiple templates at once.

Here is a partial inventory of funder template themes (full inventory coming soon) to guide your tagging efforts. You will notice that some of your guidance has already been tagged with one or more themes—we applied these programmatically during the data migration using keywords. You should evaluate the themes and make any desired changes, as well as verifying that all of your guidance is accurate and up to date. In the first screenshot above, for instance, the guidance links that have no themes will not be displayed to end users.

Admin webinar for templates and guidance

I will host a webinar focused on organizational templates and guidance topics sometime in May (TBD soon). In the interim please contact us with specific issues, questions, etc. that you would like to see covered in more detail.

And of course continue to report bugs, request enhancements, and/or tell us how much you like the new interface via GitHub Issues or the contact form.

Get your DMPTool stickers and postcards!

One last reminder that new marketing materials are in the works and scheduled to ship in May. Place your orders now!

We have lift off – DMPRoadmap launches!

fireworks

From Flickr by bbtburnham http://bit.ly/2FmYLIE

by Sarah Jones

We’re delighted to announce that the DMPTool and DMPonline sites are both now running from the new joint DMPRoadmap codebase. We pushed the MVP out to test last month and have now migrated our production services. There are lots of exciting new features (v1.0 release notes).

The site will undergo a second round of accessibility testing soon and we’ve done a number of performance and usability improvements as part of bringing together our two codebases. We have also implemented the revised set of DMP themes agreed with community input last year. For UK users this means legacy guidance for removed themes has been merged and will need editing. See more information in this news item.

We gave a demo of the new system at the IDCC conference in Barcelona last month, and also gave a paper on a landscape analysis of “Active DMPs,” charting all the work that is going on in this area internationally. This information is available on a new website http://activedmps.org to serve as a central hub of machine-actionable DMP work. We invite everyone to update the site with links to any requirements you collect, or details of new tools emerging in this area. And don’t forget to join the sessions at the next RDA plenary where the DMP Common Standards WG will be comparing data models for the different DMP tools and the Exposing DMPs WG will be defining which elements of DMPs need to be shared to which actors. We also have a paper forthcoming that touches on work in these areas: the pre-print of 10 Simple Rules for Machine-Actionable DMPs is out now in Zenodo.

There is a huge number of users of the DMPRoadmap codebase. In addition to the core DMPonline and DMPTool services, there are many other instances internationally, some hosted by the DCC, but the majority are run by external groups. We estimate 50k+ users, 400+ participating institutions internationally and a growing list of funder contacts across the globe. We encourage those hosting their own instances to migrate from the former DMPonline v4 code to DMPRoadmap, and to continue to contribute back to the joint development effort like the Portage consortium in Canada and DMP OPIDoR in France have done. Migration guidelines are available to help dev teams make the switch and we have a Slack channel for external contributors. If you aren’t already a member, join here.

As always we welcome your feedback and look forward to continuing to improve the DMP experience for everyone involved in the research enterprise.

New DMPTool launched today!

dmptool logoWe’re delighted to announce a successful launch of DMPTool version 3 today. This milestone represents the convergence of the two most popular data management planning tools—US-based DMPTool and UK-based DMPonline—into a single, internationalized platform. We plan to bring the many other installations of the tool in Canada, Australia, South Africa, Argentina, and throughout Europe along for the ride as we work together to make DMPs a more useful exercise for everyone!

Currently the DMPTool supports 226 institutions and more than 28,000 users worldwide. The new DMPTool retains all of the existing functionality plus some handy new things, all in a shiny new package:

For everyone

For organizational administrators

  • New administrator help guide
  • Updated resources for promoting the DMPTool coming soon (stickers, postcards, and slide decks). Order new promo materials using the form below.
  • Institutional branding in the main banner (upload a new logo, provide contact information)
  • Create themed guidance that can be applied across all templates
  • A usage dashboard and report of plans created by users at your organization
  • Ability to view guidance and templates created by other organizations

Order form for new stickers and postcards – we’ll ship materials in early May 2018

Please report any issues or enhancement requests via GitHub Issues. Or you can always contact us directly! If you notice anything amiss with your existing plans and/or templates, let us know and we will fix it in short order.

Prepare for launch in 3… 2… 1…

In about two weeks we will launch the new DMPTool on Tues, 27 Feb. The much-anticipated third version of the tool represents an exciting next step in what has always been a community-driven project. We’ve now successfully merged the primary US- and UK-based data management planning tools into a single codebase (DMP Roadmap): the engine under the new DMPTool hood.

Why are we doing this?

A little background for those who haven’t been following along with our codevelopment journey: in 2016 the University of California Curation Center (UC3) decided to join forces with the Digital Curation Centre (DCC) to maintain a single open-source platform for DMPs. We took this action to extend our reach beyond national boundaries and move best practices forward, with a lofty goal to begin making DMPs machine actionable (i.e., useful for managing data). We’ll continue to run our own branded services (DMPTool, DMPonline, DMPTuuli, DMPMelbourne) on the shared codebase, and incorporate partners in Canada, Argentina, South Africa, and throughout Europe who are already running their own instances (full list).

In parallel with our co-development efforts we’ve been making the rounds of Research Data Alliance, Force11, IDCC, and disciplinary meetings to collect use cases for machine-actionable DMPs (details here) and help define common standards (RDA Working Group; just posted pre-print for 10 Simple Rules for Machine-Actionable DMPs). We also got an NSF EAGER grant so we can begin prototyping muy pronto.

The new version of the DMPTool will enable us to implement and test machine-actionable things in a truly global open science ecosystem. Successful approaches to making DMPs a more useful exercise will require input from and adoption by many stakeholders so we look forward to working with our existing DMP Roadmap community (an estimated 50k+ users, 400+ participating institutions, and a growing list of funder contacts across the globe) and welcoming others into the fold!

Preparing for Launch

To help DMPTool administrators prepare themselves and their institutional users for the upcoming launch, we will host a webinar on:

Mon, 26 Feb 2018, 9-10 AM Pacific Time
Zoom link (recording on Vimeo; Q&A and slides)

By that time we’ll have a new user guide for administrators, a new Quick Start Guide for researchers, and refreshed promo materials. Everyone will have seamless access to their existing DMPTool accounts, just through a new user interface that looks and feels more like DMPonline (spoiler alert: we made it blue). And one of the most exciting things about the new tool is that it contains 34 freshly updated funder templates with links to additional funder guidance.

Stay tuned to the DMPTool communication channels in the coming weeks (blog, admin email list, Twitter) for more news and updates. We look forward to seeing you at the webinar and welcome your feedback at any point.

First annual funder template pizza party!

template editors

As we approach our target release date of Feb 2018 for the DMP Roadmap platform, the DMPTool team has embarked on a major housekeeping effort. A top-to-bottom content review is underway, and last week we began an audit of the funder templates and guidance. Ten participants gathered for an all-day, pizza-fueled event that amounted to a huge template success (but an epic pizza fail, see evidence below). We were so productive and gratified by the opportunity to analyze multiple DMP policies in a group setting that we decided to make it an annual event. Read on for more DMPTool funder template news + migration plans, followed by brief updates on the DMP Roadmap project and machine-actionable DMPs.

DMPTool funder templates

The DMPTool is a hugely popular community resource in part because it serves as a central clearinghouse of information about DMP requirements and guidance for researchers applying for grants from U.S. funding agencies. Migrating the DMPTool data to the new platform provides an opportunity to update and normalize things to maintain this value. [Side note: we’re also adding a “Last updated” field to the DMP Requirements table as an enhancement in the new platform per your feedback.]

At present the tool contains 32 templates for 16 different federal and private funders. This top 10 templates list demonstrates that our users are especially keen on getting support with NSF and NIH grant proposals, although the NEH is #7, and DOE and others aren’t far behind. Some global usage statistics to put these numbers in context: 26.8k users have created 20k plans; and we have 216 participating institutions (mostly U.S. colleges and universities).

funder-template-table

Our goals for the pizza party included: 1) ensuring that template language comes directly from the most recent versions of funder policy documents; and 2) applying themes (more on themes here). Staying up to date with DMP requirements remains a crowdsourced effort spearheaded by data librarians using the Twitter hashtag #OSTPResp and a Google spreadsheet. In the past year, two additional resources entered the scene: a list of public access plans from U.S. federal agencies at CENDI.gov and this lovely SPARC tool. Using these reference materials and some additional internet research, we updated 7 links to policy documents in the current DMPTool platform (NIH-GDS, NEH-ODH, NSF-CHE, NOAA, USDA-NIFA, Joint Fire Science Program, Sloan) and made some revisions to templates in the new platform (mostly formatting). We also identified some templates that require deeper investigation and/or consultation with agency contacts to verify the best way to present DMP requirements; between now and the release date we’ll continue to work on these templates. In addition, Jackie Wilson is contracting with us to finalize the clean-up of templates and guidance (checking links and guidance text provided by funders).

#pizzafail

#pizzafail

By January we aim to have a beta DMPTool-branded version of the new platform ready for training and testing purposes. Stay tuned for a rollout plan in the new year that includes webinars for institutional administrators, with an orientation to templates and themes. Also, please note that we will be disabling template editing functionality on 18 Dec in the current version of DMPTool to maintain the integrity of template data in the new platform. For admin users who wish to make changes to templates and guidance after that date, you can contact the helpdesk, but it would be great if you can keep changes to a minimum. All other functionality in the current DMPTool will remain the same up to the final migration date (adding new users, institutions, creating and editing plans, etc.)

A million thanks to the 2017 template fixing team: Amy Neeser, Joan Starr, Alana Miller, Jackie Wilson, Marisa Strong, Daniella Lowenberg, Perry Willett, John Chodacki, and Stephen Abrams.

DMP Roadmap update

The co-development team is busy building and refining the final MVP features. The usage dashboard is the last new feature left to add. In the meantime, parallel data migration efforts are underway at DCC to move from the existing 28 DMPonline themes to the new set of 14. By January both service teams will be working on new user guides, updating other content, testing and branding. If all continues to go smoothly, we’ll be on track for a DMP Roadmap demo at IDCC in Barcelona (19–22 Feb) and an official code release. Stay tuned!

Machine-actionable DMPs

On the machine-actionable DMP front, there are two items to report:

  1. We’ll be emailing the various DMP lists shortly to encourage everyone to participate in working meetings for the RDA WGs (DMP Common Standards & Exposing DMPs) at the next plenary. For now mark your calendars for 21–23 Mar and join us in Berlin!
  2. Following on a productive session at FORCE2017, we’re finishing a draft of the 10 Simple Rules for Machine-Actionable DMPs that we will circulate soon soon.

As always, we encourage you to contact us to get involved!

Roll up, roll up. Get yer DMP update here!

Paper seller and bench From Flickr by henry... CC-BY-NC-ND

From Flickr by henry… CC-BY-NC-ND

by Sarah Jones

Last month saw a busy Active DMPs and Domain Repositories Interest Groups joint session at the RDA Plenary in Montreal. Two new working groups have been launched to advance work in this area: one on developing Common Standards for DMPs and another on Exposing DMPs. In addition, there are multiple active projects in this space including ezDMP, the University of Queensland’s Data Management Records approach, FAIRsharing and our own DMPRoadmap project. All the slides and notes from the RDA session are available from the link above if you want to find out more. The working groups are just starting to get underway too, so please review their plans and contribute if you can.

We’ve been progressing the machine-actionable DMP agenda through the DMPRoadmap team too. With support from an RDA Europe collaboration award, we integrated the disciplinary Metadata Standards Directory (MSD) into the tool. Template administrators can choose the MSD as an answer format for metadata questions so users can browse the directory from within the tool. We’d love your feedback on this – both admins trialling it on templates and end users selecting standards. Can you find relevant standards easily? Is the functionality intuitive? Are there other features or additions you would like to see? Please try it out at https://dmponline-test.dcc.ac.uk and let us know.

RDA metadata standards directory screenshot

Integrating the MSD is just one small step on the path to improving the DMP experience. We also plan to surface other registries, such as FAIRsharing and re3data, to recommend appropriate standards and services. Experimentation in this area will also aim to facilitate the exchange of information between systems and alert services to data in the pipeline. The DMPTool team have just received a 2-year NSF EAGER grant to address these bigger aims! The work plan includes pilot projects with the Biological and Chemical Oceanographic Data Management Office (BCO-DMO) at Woods Hole, MA and understanding the institutional workflow in collaboration with Purdue and others. Find out more on the DMPTool blog; additional details forthcoming as we refine the work plan.

The next stop for us is FORCE2017 in Berlin next week. We’ll be running a session on 10 Simple Rules for Active DMPs on Friday morning (27 Oct) in collaboration with the FAIR DMP group. The session will introduce participants to the concepts of FAIR and machine-actionable DMPs and then build community consensus around common goals and definitions. We’ve been working on a draft that we’ll share and iterate on at the meeting. Join us there if you can!

We’re also looking forward to the International Digital Curation Conference (IDCC) in Barcelona next February. The call for papers is out now and closes later this month. Last year we outlined ideas for Next-Generation DMPs (here) and hosted a workshop that resulted in this white paper with community-generated use cases for machine-actionable DMPs. Thanks again to all those who contributed to defining these preliminary requirements for the work now being addressed by us and the RDA working groups. IDCC is a great opportunity to get international input on your ideas so share what you’ve been working on and join us in Barcelona!

NSF EAGER Grant for Actionable DMPs

We’re delighted to announce that the California Digital Library has been awarded a 2-year NSF EAGER grant to support active, machine-actionable data management plans (DMPs). The vision is to convert DMPs from a compliance exercise based on static text documents into a key component of a networked research data management ecosystem that not only facilitates, but improves the research process for all stakeholders.

Machine-actionable “refers to information that is structured in a consistent way so that machines, or computers, can be programmed against the structure” (DDI definition). Through prototyping and pilot projects we will experiment with making DMPs machine-actionable.

Imagine if the information contained in a DMP could flow across other systems automatically (e.g., to populate faculty profiles, monitor grants, notify repositories of data in the pipeline) and reduce administrative burdens. What if DMPs were part of active research workflows, and served to connect researchers with tailored guidance and resources at appropriate points over the course of a project? The grant will enable us to extend ongoing work with researchers, institutions, data repositories, funders, and international organizations (e.g., Research Data Alliance, Force11) to define a vision of machine-actionable DMPs and explore this enhanced DMP future. Working with a broad coalition of stakeholders, we will implement, test, and refine machine-actionable DMP use cases. The work plan also involves outreach to domain-specific research communities (environmental science, biomedical science) and pilot projects with various partners (full proposal text).

Active DMP community

Building on our existing partnership with the Digital Curation Centre, we look forward to incorporating new collaborators and aligning our work with wider community efforts to create a future world of machine-actionable DMPs. We’re aware that many of you are already experimenting in this arena and are energized to connect the dots, share experiences, and help carry things forward. These next-generation DMPs are a key component in the globally networked research data management ecosystem. We also plan to provide a neutral forum (not tied to any particular tool or project or working group) to ground conversations and community efforts.

Follow the conversation @ActiveDMPs #ActiveDMPs and activedmps.org (forthcoming). You can also join the active, machine-actionable DMP community (live or remote participation) at the RDA plenary in Montreal and Force11 meeting in Berlin to contribute to next steps.

Contact us to get involved!