Skip to content

Share your ARC

Tailwind CSS chat bubble component

Now I have created my local ARC, but how can I share it with my colleagues?

Using the PLANTDataHUB for collaboration

Section titled Using the PLANTDataHUB for collaboration

ARCs are the basis of the collaborative research platform and can be seamlessly shared between researchers by using the PLANTDataHUB.

DataPLANT Account

If you do not have an account, please register with DataPLANT to use the PLANTDataHUB.

Follow these instructions to sign up

With a DataPLANT account you can use the DataHUB and share your ARC for collaboration.

Please register here.

During the registration you can “Choose your role in DataPLANT”:

  • DataSteward
    • Member of / associated to DataPLANT
    • Teaches DataPLANT tools and services to community members
  • Developer
    • Member of / associated to DataPLANT
    • Develops DataPLANT tools and services
  • Member
    • Other member of DataPLANT
  • User
    • User who want to use the DataPLANT tools and services

If you want to adjust your account settings, simply click the login icon in the navigation bar on this site.

  • In the tab “Password” you can modify your password.
  • In the tab “Authenticator” you can set up Two Factor Authentication (2FA).

The ARC comes with a mechanism to track changes. This version control is based on git. Briefly, snapshots of an ARC are called Commits. Every Commit is encoded with the information on who made the change and when and it is accompanied with a note, i.e. a “Commit message” that allows the user to communicate what was changed.

In order to retreive your user information and associate it with your commits, you need to login to the DataHUB.

ARCitect

  1. Click Login in the sidebar.

  2. Select git.nfdi4plants.org as DataHUB from the dropdown menu.

  3. Click Login.

    Tailwind CSS chat bubble component

    Great, now I have some new functions activated in the sidebar. What are they for?

The commit menu allows you to “commit” your changes locally. This saves the changes of your local ARC together with your DataHUB credentials (Name and eMail).

ARCitect

  1. Navigate to the Commit menu.

  2. Since you are logged in, the Name and eMail of your DataHUB account are automatically added.

  3. Add a commit message:

    Tailwind CSS chat bubble component

    “Created my first ARC and added data.”

  4. Click Commit to store your changes locally.

In the History menu you can inspect your ARC history with all commit messages.

ARCitect

  1. Navigate to the History menu.

  2. Find your commit messages.

    Tailwind CSS chat bubble component

    Great, so even in five years I will know what I did in every step.

Upload your ARC to the PLANTDataHUB

Section titled Upload your ARC to the PLANTDataHUB

ARCitect

  1. From the sidebar, navigate to the DataHUB Sync menu.

  2. In the grey Remote box, click + to add a remote.

  3. In the Add Remote dialog, leave the defaults for Remote Name, DataHUB Account and URL.

  4. Click Add Remote.

  5. Click Push to upload your ARC to the DataHUB.

  6. In the grey Remote box, click the globe icon to be directed to your ARC in the DataHUB.

Explore your ARC in the PLANTDataHUB

Section titled Explore your ARC in the PLANTDataHUB

PLANTDataHUB

  1. Sign in to the PLANTDataHUB
  2. Navigate to your ARC.
  3. Browse the files of your ARC.
  4. The main panel of the ARC menu mimics the local folder structure
Tailwind CSS chat bubble component

Now my ARC is stored in the PLANTDataHUB, but how can I add my project partner?

PLANTDataHUB

  1. Click on Manage in the left navigation panel.

  2. Click on Members.

  3. Click on Invite members.

  4. Search for potential collaborators.

  5. Select a role.

When inviting new members to an ARC or group, you can choose between different roles.

  • Guest – Has the least rights. They will not be able to see the content of an ARC (only the wiki page).

  • Reporter – Has read access to your ARC. This is recommended for people you ask for consultancy.

  • Developer – The choice for most people you want to invite to your ARC. Developers have read and write access, but cannot maintain the project on the DataHUB, e.g. invite new members.

  • Maintainer – Has read and write access and can add or remove members, except for yourself. This is the minimum role recommended for inviting group leaders as it allows them to add their group members for data upload or analysis to the project.

  • Owner – An owner has basically all rights to the ARC. They can delete or transfer the ARC and manage user memberships.

Tailwind CSS chat bubble component

I will invite my PI Prof. Jasmine Beetroot as Maintainer and my collaboration partner Oliver Sage as Developer.

The DataHUB can also be used for Project Management. With issues you can collaborate on ideas and plan your work.

PLANTDataHUB

  1. Click on Plan in the left navigation panel.

  2. Click on Issues.

  3. Create a new Issue.

    Tailwind CSS chat bubble component

    It would be good to have summary statistics for sugar measurement from my project collaborator.

  4. Type in a Title Summary statistics for sugar measurement.

  5. Fill out the Description.

  6. Assign yourselve or collaboration partner to the task.

  7. Click Create Issue.