diff --git a/TeSS_docs/_toc.yml b/TeSS_docs/_toc.yml index aa72c6d..d183530 100644 --- a/TeSS_docs/_toc.yml +++ b/TeSS_docs/_toc.yml @@ -13,6 +13,11 @@ parts: - file: overview/definitions - file: overview/what-we-catalogue - file: overview/fair + - caption: Roles + chapters: + - file: roles/administrator + - file: roles/trainer + - file: roles/content_provider - caption: Search chapters: - file: search/searching diff --git a/TeSS_docs/accounts/user.md b/TeSS_docs/accounts/user.md index fcfd002..cc2a19a 100644 --- a/TeSS_docs/accounts/user.md +++ b/TeSS_docs/accounts/user.md @@ -4,9 +4,9 @@ A TeSS instance is viewable by everyone, you do not need to register to search o The materials that TeSS points to may be restricted-access, but the registry itself is open. If you want to register your materials, you can register for a user account. -```{admonition} Note for mutli-space TeSS instances +```{admonition} Note for multi-space TeSS instances :class: note -If a TeSS instanace has multiple [spaces](../spaces/intro-spaces), please register one user account for all spaces. +If a TeSS instance has multiple [spaces](../spaces/intro-spaces), please register one user account for all spaces. For security reasons, if the spaces are on different domains (`site1.com` and `site2.com`), you will need to log in to each space separately, even though you are using the same account. ``` diff --git a/TeSS_docs/roles/administrator.md b/TeSS_docs/roles/administrator.md new file mode 100644 index 0000000..14dc273 --- /dev/null +++ b/TeSS_docs/roles/administrator.md @@ -0,0 +1,9 @@ +# Administrator + +As an administrator, you have many rights inside HEP Training. An administrator can: + +- create/delete spaces (public and private) +- manage users +- manage resources + +They are the primary person to address requests of any kind which require a high level of privileges. \ No newline at end of file diff --git a/TeSS_docs/roles/content_provider.md b/TeSS_docs/roles/content_provider.md new file mode 100644 index 0000000..60dc7dc --- /dev/null +++ b/TeSS_docs/roles/content_provider.md @@ -0,0 +1,5 @@ +# Content provider + +A content provider is an organization which proposes resources on HEP Training. + +To register a content provider, go to [https://heptraining.cern.ch/content_providers/new](https://heptraining.cern.ch/content_providers/new) and add the content provider. You will be the owner of it. diff --git a/TeSS_docs/roles/trainer.md b/TeSS_docs/roles/trainer.md new file mode 100644 index 0000000..dcbe6b8 --- /dev/null +++ b/TeSS_docs/roles/trainer.md @@ -0,0 +1,5 @@ +# Trainer + +As a trainer, you have a public profile on HEP Training and you are featured on the main page. It helps people to see your work. + +To create your profile, click on your username on the top-right of the navigation bar and go to "My profile" > Edit profile. You will find a "Trainer Details" form where you can enter your info. \ No newline at end of file diff --git a/TeSS_docs/search/searching.md b/TeSS_docs/search/searching.md index ad2ff6e..0c565ca 100644 --- a/TeSS_docs/search/searching.md +++ b/TeSS_docs/search/searching.md @@ -46,7 +46,7 @@ To perform a filtered search on a particular type of training: 1. In the top menu, click the type of training you wish to search. 2. You can enter **keywords** in the search box above the results. 3. You can **sort** results by date or title using the control on the left. -4. You can **filter** results by multiple paramaters using the controls on the left. +4. You can **filter** results by multiple parameters using the controls on the left. - For example, search across all spaces in a TeSS instance by clicking 'Show materials from all spaces'. 5. You can move through the pages of results at the bottom of the page. diff --git a/TeSS_docs/spaces/intro-spaces.md b/TeSS_docs/spaces/intro-spaces.md index b1b46f3..8a3f6a5 100644 --- a/TeSS_docs/spaces/intro-spaces.md +++ b/TeSS_docs/spaces/intro-spaces.md @@ -5,13 +5,21 @@ Each community registers, maintains and curates their material for their members This new feature is possible thanks to the [mTeSS-X project](../overview/mtess-x). Catalogues are pooled into a shared instance but look to their community as if they have their own catalogue with their own identity. -There are two types of spaces, depending on the configuration of the TeSS instance: -- **public space** (default): its resources are visible to everybody viewing the space (and visible in the main catalogue with a filter). You do not have to be logged in. -- **private space**: its resources are not visible outside the space (even with the filter in the main catalogue to see resources from other spaces). A private space requires the user to be associated with a relevant group. You have to be logged in. - ```{image} ../images/spaces/graphic-multi-space.svg :alt: Graphic of multi-spaces :class: mb-1 :width: 300px :align: center ``` + +## Public and private space + +There are two types of spaces, depending on the configuration of the TeSS instance: +- **public space** (default): its resources are visible to everybody viewing the space (and visible in the main catalogue with a filter). You do not have to be logged in. +- **private space**: its resources are not visible outside the space (even with the filter in the main catalogue to see resources from other spaces). A private space requires the user to be associated with a relevant group. You have to be logged in. + + +## Deleting a space + +- **Deleting private space**: deletes the resources linked to the space, but the administrator must erase the route associated to the space to avoid users to still visit the private space URL (which shows the default space). +- **Deleting public space**: moves material in the default space, thus shows it to any user.