If you are having trouble with the sign in process, please <ContactLink>contact the SSH Open Marketplace team</ContactLink>.

If you are having trouble with the sign up process, please <ContactLink>contact the SSH Open Marketplace team</ContactLink>.

Subject

Social Sciences & Humanities Open Marketplace

Successfully submitted!

The first step in the creation of a workflow is to **identify and shape** a topic for your workflow. A good workflow is built on use cases, inspired from real life, and aims at supporting and providing expertise to researchers in their use of digital methods.

As stated in the [SSK documentation](https://ssk.readthedocs.io/en/latest/1_tuto.html): “These scenarios can be seen as a living memory of what should be the best research practices in a given community, made accessible and reusable for other researchers wishing to carry out a similar project but unfamiliar with the recommended tools, formats, methods to use, etc”. 

In case of collaborative work, it might be useful to prepare the workflow in a [collaborative template](https://docs.google.com/document/d/1Vqk3E0n2_ZY2oYar21x5-ifHhK7KjxiV5X9ZdNAGFfQ/edit?usp=sharing) before creating the workflow in the Marketplace via the edit form.

The description of the workflow is the longer text that the contributor has to provide.
- it should explain the scientific problematic and describe the solution put in place.
- it is important to extend the acronyms cited and to briefly present the projects mentioned.

The form of this text should respect the following constraints:
- It shouldn’t exceed 1500 characters (but should not be too short either).
- You can use Markdown syntax to format your description


In order to enhance discoverability and search relevance, the SSH Open Marketplace resources are described with a set of metadata. All available metadata are described and documented in the **[SSH Open Marketplace editorial guidelines](https://marketplace.sshopencloud.eu/contribute/metadata-guidelines#guidance-for-metadata-fields)**, the most relevant to associate with a workflow are highlighted here.

*Categorisation metadata*
- (research) activities to be chosen among the concepts from [TaDIRAH (Taxonomy of Digital Research Activities in the Humanities)](https://vocabs.dariah.eu/tadirah/en/)
- Keyword
- Language

*Context metadata*
- see-also
- helpdesk-url

*Access metadata*
- license

*Actors*
- all authors of the workflow should be added as actors 
- it is possible to add ORCID, Twitter account, email, website... on an actor profile


- The illustration must closely relate with the purpose of the scenario, i.e. not only with the discipline or the period studied.
- Screenshots are accepted.
- Landscape orientation image are recommended
- It must be published under the licence CC-BY or CC-0.

As in a cooking recipe, you need to **determine the different steps needed** for someone else to perform the workflow and reuse the digital method presented in your research scenario. One step describes an action (or a set of actions) needed to realise the workflow and links useful resources that can be used to perform this action, or to understand the methodology used. Steps are usually temporarily ordered. You can add as many steps as you want, but we recommend to not exceed 10 steps.

A few recommendations to describe a step:
1. Choose explicit titles starting with a verb or a gerund  

The choice of good titles for steps is crucial. They will be the entry point for the readers, who need to understand at first reading the scope and the aim of a step. To ensure that the message will driven home, we advice to build titles:
- that starts with a verb or a gerund, describing the process (for a scenario) or the action (for a step) that the user will read about;
- with a number of characters comprised between 10 and 100.

2. Write the description 

It should describe the purpose of the action, how it relates with the previous ones and give an overall presentation of the different kind of methods and tools the resources would point to.
- it is important to extend the acronyms cited and to briefly present the projects mentioned. 
 - The text shouldn’t exceed 1500 characters (but should not be too short either). 
- You can use Markdown syntax to format your description



Identifying state of the art references is a prerequisite before actually adding the resources to the steps. When we are talking about resources, we mean a tool, service or document helpful for the task completion.
To be linked to the workflow or its steps, these resources need to have an entry in the SSH Open Marketplace.

1. Check if the resource is already referenced in the Marketplace via the search function.
2. If yes, check whether or not the item needs to be enriched with additional metadata. Improve the item description if needed. 
3. If no, create an entry for the resource you want to link to the step, following the editorial guidelines recommendations.  


Klaus  Illmayer

Laurent Romary

Laure Barbot

Matej  Ďurčo

Edward Gray

Charles Riondet

Marie Puren

Nicolas Larrousse

The following workflow helps users understand what a workflow is in the SSH Open Marketplace and how to proceed to create one. 

As described in the [Marketplace’s guidelines](https://marketplace.sshopencloud.eu/about/data-population): ”A research workflow is a (potentially complex/non-linear) sequence of steps to describe how to perform a task within the research data lifecycle (comparable to 'recipes' in [methodi.ca](http://methodi.ca/) and 'scenarios' in the [Standardization Survival Kit](https://hal-lara.archives-ouvertes.fr/hal-01513531/)). A workflow can be completed by using diverse tools and resources, connected to each step. As opposed to Training Materials, workflows are a series of steps (which can contain links to other resources) whereas the former are unique resources.”

**This specific workflow guides users, step by step, in the creation of their own research scenario.** Let's highlight first the three main reasons for which you, as a researcher, want to contribute to the SSH Open Marketplace with a workflow:
- to make your research project align with the best practices in your community
- to get peer review and visibility
- to share a project in another form than the usual blog / article (a new way to disseminate your work).


How to create a workflow in the SSH Open Marketplace?

Media

Workflow steps(6)

1 Identify a good workflow

2 Describe your workflow

3 Associate metadata to the workflow

4 Choose an illustration for the scenario

5 Create and describe steps

6 Identify and reference relevant resources