Share Narratives

Narratives are collaborative (multiple people on your project can work on a Narrative together), shareable (you can share your Narrative with specific people or with everyone), publishable (a finished Narrative is similar to a research paper, and can be cited as a URL), and reproducible (you can repeat or even change another scientist’s computational experiment if they publish it as a Narrative). We believe that you will ultimately help both yourself and other researchers by sharing your Narratives so that others can see what you were thinking, what you did, and what you concluded from your analyses. However, rest assured that all of your Narratives are private (viewable only by you) until you decide to share them.

You can share a Narrative that you own with any set of people you choose, or with all KBase users. To share a Narrative, click the “share” button near the top right of the page. You will see the people you have already shared with (right now, only you).

If you want to share your Narrative with everyone, you can click the “make public” link near the top of the sharing panel. If you only want to share it with a few people, you can type their name or username into the “share with” box. Once you have typed something that matches a name in the KBase user database, the person’s full name will appear. Click the down arrow to the right of the “share with” box to assign permissions to that user–you can allow them only to view your Narrative, to edit it, or to edit and share it.

For example, suppose you want to share your Narrative with kbasehelp so that KBase staff can help you troubleshoot it. You can start typing any part of the username or real name and a list of users that match will appear:

The default permission level for sharing is “View only”, which lets the user you’re sharing with see the Narrative but not let them edit it or share it with others. If you want to share your Narrative with a collaborator and give them more privileges, click the down-arrow to see the permission levels and possibly choose a different one.

You can add multiple users to share with:

Click the “Apply” button to add the chosen user(s) to the sharing list for your Narrative. The usernames and permission levels for the users you shared with will appear at the bottom of the Share panel.

You can also choose to share your Narrative with all KBase users by clicking the “make public?” link.

When you’re done sharing, click the x  to close the Share panel.

You can change the access permissions at any time by clicking the Share button again. The up/down arrows next to each user’s permissions let you change the permissions.

Note that unless you alert another user that you have shared a Narrative with them, they will not notice until they happen to see your shared Narrative in their “Narratives that have been shared with you” tab or click on your name in her collaborator list. In the future, the Narrative Interface will alert you to new Narratives that have been shared with you.

If you are working on a shared Narrative, and a collaborator is working on it at the same time, watch for a red box at the top of the screen that says “Narrative updated in another session.” You can update to the latest version by refreshing the page, but note that any changes that you made to the Narrative will be lost, and if you try to save your changes, you might overwrite your collaborator’s changes. We are working on better ways to allow simultaneous editing.

Create or modify your user profile

Every KBase user has a user profile. Filling in your KBase user profile helps you become part of the social web that KBase is building, making it easier to find and collaborate with other scientists and share data and Narratives. You are not required to complete your user profile in order to use KBase, but we encourage you to.

image30To view your user profile, click on your avatar in the upper right corner of the window, and then select your username from the two-item dropdown menu. A new tab will open with your profile. The profile page also lets you search for other users and see a list of Narratives that you have created. Your collaborators (other users with whom you have shared Narratives, or who have shared Narratives with you) are listed as well.

If you want to edit information in your profile, use the Account button in the left margin. You will be able to enter or change your organization, research interests, avatar, and more. Click the Save button on the upper right of the Account page to save your changes.

The user profile editor, and KBase’s social networking layer, are in development. Soon you will be able to search for other researchers whose interests overlap with yours, perhaps inviting them to collaborate. You will also be able to see how many times your Narratives were run, copied, extended or cited. Ultimately, we hope that KBase’s expanding social web will help to make systems biology research more effective, collaborative, and reproducible.