From 9d5d56ee06807da354ede33e8879fcd9cee82f13 Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Wed, 12 Nov 2025 17:16:53 +0000 Subject: [PATCH 1/3] Add page about collections --- TeSS_docs/_toc.yml | 1 + TeSS_docs/content/collections.md | 52 ++++++++++++++++++++++++++++++++ 2 files changed, 53 insertions(+) create mode 100644 TeSS_docs/content/collections.md diff --git a/TeSS_docs/_toc.yml b/TeSS_docs/_toc.yml index 3fcf1af..d7d6302 100644 --- a/TeSS_docs/_toc.yml +++ b/TeSS_docs/_toc.yml @@ -30,6 +30,7 @@ parts: - file: content/manual sections: - file: content/manual-events-materials + - file: content/collections - file: content/learning-paths - caption: Developers chapters: diff --git a/TeSS_docs/content/collections.md b/TeSS_docs/content/collections.md new file mode 100644 index 0000000..c5f4cbe --- /dev/null +++ b/TeSS_docs/content/collections.md @@ -0,0 +1,52 @@ +# Collections in TeSS + +## What is a collection? + +Collections can be thought of as folders in which users may collect particular training materials or events, from the full catalogue available within TeSS to address their specific training needs. Collections are visible to the public by default. + +## Creating collections + +```{tip} +You must register training materials or events before you create a collection. +``` + +Steps to create a collection: + +1. On the 'Collections' tab, click the 'Create collection' button at the top-right. +2. Give the collection a title (required), description, image and keywords. +3. The collection will be public by default. Un-ticking the 'Public' box will hide this collection from anyone who isn't the creator or a collaborator. +4. To add a training material to the collection, click in the ‘Add a new material’ box and begin to type its name. Select the correct material. You can provide a comment to be displayed with the material, if you wish to provide additional context or explain which parts of the material are relevant to the collection. +5. Repeat step 4 to add multiple materials for this collection. +6. To add an event to the collection, click in the ‘Add a new event’ box and begin to type its name. Select the correct event. You can provide a comment. +7. Repeat step 6 to add multiple materials for this collection. +8. You can reorder the materials and events using the arrow icons. +9. When you have finished, click the ‘Create Collection’ button. + + +### Managing collaborators + +Collaborators are TeSS users who can edit a collection after it has been created. Only the collection owner can add and remove collaborators. To add a collaborator: + +1. Navigate to the page for that collection. +2. Click the ‘Collaborators’ button at the top-right of the page. +3. Start to type the name or username of the collaborator you wish to add and select them. The collaborator needs to be a registered user of TeSS. +4. Repeat for any additional collaborators. +5. When you have finished, click the ‘Done’ button. + + +### Updating collections + +To update a collection, you need to be the owner or a collaborator: + +1. Navigate to the page for that collection. +2. Click the ‘Edit’ button at the top-right of the page. +3. Make your changes then click the ‘Update Collection’ button at the bottom. +4. If you wish to delete the collection, use the ‘Delete’ button next to the ‘Edit’ button on the page for that item. + + +## Viewing collections + +Collections can be browsed and searched in TeSS. They are organised by keyword. + +1. To view the collections, click ‘Collections’ in the main menu. (Tip: To view a collection you do not need to be logged in to TeSS.) +2. Click to view a collection. Read the summary box. The details of the included training materials and events appear in two tabs; click each item to open it. Information about the collection appears on the left. From 9120d6c428e3bd14c92c0832cf4a9a9869172cb8 Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Wed, 12 Nov 2025 17:39:36 +0000 Subject: [PATCH 2/3] Add workflows page --- TeSS_docs/_toc.yml | 1 + TeSS_docs/content/workflows.md | 51 ++++++++++++++++++++++++++++++++++ 2 files changed, 52 insertions(+) create mode 100644 TeSS_docs/content/workflows.md diff --git a/TeSS_docs/_toc.yml b/TeSS_docs/_toc.yml index d7d6302..eaee172 100644 --- a/TeSS_docs/_toc.yml +++ b/TeSS_docs/_toc.yml @@ -31,6 +31,7 @@ parts: sections: - file: content/manual-events-materials - file: content/collections + - file: content/workflows - file: content/learning-paths - caption: Developers chapters: diff --git a/TeSS_docs/content/workflows.md b/TeSS_docs/content/workflows.md new file mode 100644 index 0000000..401799a --- /dev/null +++ b/TeSS_docs/content/workflows.md @@ -0,0 +1,51 @@ +# Workflows in TeSS + +## What are workflows in TeSS? + +Training workflows in TeSS are visual, step-by-step protocols that allow users to navigate materials in TeSS in topic- or task-related ways. +For example, they may encapsulate typical stages of particular kinds of data analysis (protein sequence analysis, structure analysis, etc.), where each stage/node in the workflow represents a given analysis step and links to the corresponding training resources. Workflows are visible to the public by default. + + +## Creating workflows + +Steps to create a workflow: + +1. On the 'Workflows' tab, click the 'Create workflow' button at the top-right. +2. Give the workflow a title (required), description. Click to expand the 'Extra metadata' box if you wish to give DOI, scientific topics, keywords, target audience, difficulty level, licence, authors or contributors. +3. Child nodes will be shown by default. Ticking the 'Hide child nodes' box will hide child nodes from the diagram until their parent node is clicked. +4. The workflow will be public by default. Un-ticking the 'Public' box will hide this workflow from anyone who isn't the creator or a collaborator. +5. To add a node to the workflow, click in the ‘Add node’ button and click on the diagram to select where you wish to add the node. Give the node a title, description, terms and colour. Add associations from the choice of training material, event, tool or policy: each association has a title and a URL. When you have finished, click the 'Done' button. +6. Repeat step 5 to add multiple nodes for this workflow. +8. You can move the nodes in the diagram area. +9. When you have finished, click the ‘Create workflow’ button. + + +### Managing collaborators + +Collaborators are TeSS users who can edit a workflow after it has been created. Only the workflow owner can add and remove collaborators. To add a collaborator: + +1. Navigate to the page for that workflow. +2. Click the ‘Collaborators’ button at the top-right of the page. +3. Start to type the name or username of the collaborator you wish to add and select them. The collaborator needs to be a registered user of TeSS. +4. Repeat for any additional collaborators. +5. When you have finished, click the ‘Done’ button. + + +### Updating workflows + +To update a workflow, you need to be the owner or a collaborator: + +1. Navigate to the page for that workflow. +2. Click the ‘Edit’ button at the top-right of the page. +3. Make your changes then click the ‘Update workflow’ button at the bottom. +4. If you wish to delete the workflow, use the ‘Delete’ button next to the ‘Edit’ button on the page for that item. + + +## Viewing workflows + +Workflows can be browsed and searched in TeSS. They are organised by scientific topic, target audience, keyword, licence, difficulty level, author and contributor. + +1. To view the workflows, click ‘Workflows’ in the main menu. (Tip: To view a workflow you do not need to be logged in to TeSS.) +2. Click to view a workflow. Read the summary box on the right. The details of the included nodes appear in the main area; click each item to open it. +3. To create a personal collection of your favourite workflows, click the star icon at the top of each workflow to add them to a list. You can view your starred resources later by clicking the user icon at the top-right of the screen then 'My stars'. To use the star feature you need to be a registered TeSS user. +4. To embed the workflow in your website, click the 'Embed' button at the top-left. Copy the the snippet and paste it into your HTML/markdown. The width and height of the embedded workflow can be adjusted by changing the parameters on the iframe element. From 1f9cb63551bc384dcd3b732db7cc4f56787990e6 Mon Sep 17 00:00:00 2001 From: Phil Reed Date: Wed, 12 Nov 2025 18:25:02 +0000 Subject: [PATCH 3/3] Remove unnecessary tip on collections --- TeSS_docs/content/collections.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/TeSS_docs/content/collections.md b/TeSS_docs/content/collections.md index c5f4cbe..d01f549 100644 --- a/TeSS_docs/content/collections.md +++ b/TeSS_docs/content/collections.md @@ -6,10 +6,6 @@ Collections can be thought of as folders in which users may collect particular t ## Creating collections -```{tip} -You must register training materials or events before you create a collection. -``` - Steps to create a collection: 1. On the 'Collections' tab, click the 'Create collection' button at the top-right.