From 496d78cb18dfac54707818835e0a9401f15226c8 Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Wed, 5 Aug 2026 09:19:41 +0100 Subject: [PATCH 1/4] Fix typo in user.md regarding multi-space instances --- TeSS_docs/accounts/user.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) 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. ``` From ac8157dca64acebaa2d781fc2432b980af0631ed Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Wed, 5 Aug 2026 09:24:15 +0100 Subject: [PATCH 2/4] Fix typo in filtering parameters instruction --- TeSS_docs/search/searching.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) 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. From 19755737ee146c67ecee2dca79895e857e5cab6c Mon Sep 17 00:00:00 2001 From: = Date: Wed, 19 Aug 2026 11:26:21 +0200 Subject: [PATCH 3/4] feat: add infos for space deletion --- TeSS_docs/spaces/intro-spaces.md | 16 ++++++++++++---- 1 file changed, 12 insertions(+), 4 deletions(-) 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. From eb504fee7d70a3e8a23e7c3225a6fffc8ee6d8a4 Mon Sep 17 00:00:00 2001 From: = Date: Wed, 19 Aug 2026 13:48:39 +0200 Subject: [PATCH 4/4] feat: add infos to roles --- TeSS_docs/_toc.yml | 5 +++++ TeSS_docs/roles/administrator.md | 9 +++++++++ TeSS_docs/roles/content_provider.md | 5 +++++ TeSS_docs/roles/trainer.md | 5 +++++ 4 files changed, 24 insertions(+) create mode 100644 TeSS_docs/roles/administrator.md create mode 100644 TeSS_docs/roles/content_provider.md create mode 100644 TeSS_docs/roles/trainer.md 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/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