Skip to content

Commit

Permalink
Change name and update join_create_teams_spaces.md
Browse files Browse the repository at this point in the history
  • Loading branch information
supernord committed Aug 18, 2023
1 parent 22efa96 commit 0b6dc69
Show file tree
Hide file tree
Showing 2 changed files with 104 additions and 106 deletions.
104 changes: 104 additions & 0 deletions docs/join_create_teams_spaces.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,104 @@
---
title: Joining and creating WorkflowHub Spaces, Teams & Organizations
redirect_from:
- /How-to-join-a-project/
- /joining-a-team
---

When you have registered and logged in, the next step is to either create, or join, a **Team**. To do this, you need to have either selected, or created, both a **Space** and an **Organisation**. This page provides additional details for each of these concepts.


## Terminology

For a description of `Spaces`, `Teams` and `Organisations` please [see this page](/docs/space_team_organisation.md).

{% include image.html file="spaces_teams_organizations.png" caption="Fig 1. Structure of spaces, teams and organizations. Note that there is flexibility in how spaces are structured, and that you can be part of multiple Spaces, Teams and Organizations." %}


## Would you like to join a Team?

You can join one or more existing Teams by:


<p>
<a class="btn-collapse" data-toggle="collapse" href="#collapse1" role="button" aria-expanded="false" aria-controls="collapse1">
Joining an existing Team immediately after registration
</a>
</p>

<div class="collapse" id="collapse1">
<div class="card card-body">

After registration, you will be prompted to either join or create a Team. When selecting to join, you can type to automatically search for the Team and candidates will appear which you can select. You can select up to 3 at one time. You can also browse, and join by requesting membership directly from a Team page (see below).

Once the Team(s) are selected, the process is the same as requesting membership directly from a Team page.

</div>
</div>


<p>
<a class="btn-collapse" data-toggle="collapse" href="#collapse1" role="button" aria-expanded="false" aria-controls="collapse1">
Requesting membership of an existing Team
</a>
</p>

<div class="collapse" id="collapse1">
<div class="card card-body">

If a Team has an administrator, and you are not already a member - then a `request membership` button will appear on the Team page. You can browse, filter and search Teams from the Browse menu at the top of the page.

After clicking this button, the Team will automatically be selected, and you then need to provide your Organization. Start to type the name of **your** Organization, and existing options will be displayed that contain the text you type (you can also type information related to the Organization such as city or country). Hopefully, your Organization is found, and you can just select it. If not, you can choose the top option to define a new one.

- Only the title is required for a new Organization, but you can also provide details about its website, city and country.
- You will be able to edit and add additional information afterwards.

Finally, you also have the option to provide a comment to describe why you wish to join the Team. This is particularly important if you are not already known by the Team administrator.

Once submitted, the administrators of the Team will be notified and will either approve or reject your request, and you will be notified by email.

</div>
</div>


## [Create your own Team](https://workflowhub.eu/projects/guided_create)

You will be prompted to create a Team when you register a new account. If you are already a member and wish to create additional Teams, you can choose to create one from the `Create` drop down menu in the top navigation bar. [Here is a direct link](https://workflowhub.eu/projects/guided_create).

The steps for creating a Team are outlined here:

1. A `Space` will first need to be chosen or created.

- By default, the site managed Space is selected (called `Independent Teams`), but if unchecked there is an option to provide the title of a new one.
- If you already administer an existing Space, a dropdown box will be shown instead allowing you to select it.
- Only the title is required at this stage, and further details can be added once the Team has been created.

2. You next need to define the `Team`. The minimum requirement is a Title, but you can also provide a:
- Description, and
- Webpage URL

{% include callout.html type="note" content="Once created you can edit and add additional details and add members." %}

3. You then need to define **your** Organization.
4. Start to type the name of your Organization, and existing options will be displayed that contain the text you type (or information related to the Organization such as city or country).
- Hopefully, your Organization is found, and you can then select it, or
- If not, you can choose the top option to define a new one.
- Only a title is needed for a new Organization, but you can also provide details about its website, city and country. You will be able to edit and add additional information afterwards.

5. Once submitted, relevant administrators will be notified. They will review and either accept or reject the new `Team` and / or `Space`.

{% include callout.html type="important" content="If you are creating a new Team within your own Space, you can review and approve it immediately yourself.
" %}

{% include image.html file="create_space_team_organization.png" caption="Fig 2. Wizard for creating spaces, teams and organizations. " alt="Wizard for creating spaces, teams and organizations." %}


## Approval

If you are creating a `Team` within a `Space` you administer, then there is no approval step. You will be shown a page to review the details and then can create straight away.

Otherwise, the process is:

1. An appropriate administrator will be notified by email, and via WorkflowHub itself, about your request,
2. In WorkflowHub, they will be shown a page that allows them to quickly review the details and either accept or reject the request, and
3. In either case you will be notified by email. During the working day (according to the timezone of the member notified) this will normally be a quick process.
106 changes: 0 additions & 106 deletions docs/joining-a-team.md

This file was deleted.

0 comments on commit 0b6dc69

Please sign in to comment.