Merge pull request #18 from ElixirTeSS/search-section

Search section, searching page

Author: PhilReedData

TeSS_docs/_toc.yml

@@ -11,11 +11,14 @@ parts:
     - file: overview/mtess-x
     - file: overview/definitions
     - file: overview/what-we-catalogue
+  - caption: Search
+    chapters:
+    - file: search/searching
+    - file: search/subscribe
   - caption: Account creation
     chapters:
     - file: accounts/user
     - file: accounts/provider
-    - file: accounts/subscribe
   - caption: Space creation
     chapters:
     - file: spaces/intro-spaces

TeSS_docs/overview/definitions.md

@@ -229,6 +229,32 @@ Associations
     For each association, provide a title and a URL.
 ```
 
+## Searching
+
+Definitions of filters and other controls that show when searching for training.
+
+```{glossary}
+
+Only show online events
+    Hide events that are marked as Face-to-face. False by default.
+    
+Show events/materials from all spaces
+    Show training that match your search criteria from all spaces on this TeSS instance, not just the current space. False by default.
+
+Show past events
+    Show events where the date is in the past. False by default.
+    
+Show disabled events/materials
+    Show training where the provider has chosen not to show the event yet in search results, perhaps because the event entry is still in development. False by default.
+
+Show hidden items
+    This filter is for curators only. Show training created by unverified users, and users that have been flagged as spammers. False by default.
+
+Show archived materials/learning paths/collections
+    Show training where the provider has set the [status](#term-Status) as Archived.  False by default.
+
+```
+
 
 ## Roles
 

TeSS_docs/overview/tess.md

@@ -15,16 +15,3 @@ TeSS was originally developed as part of [ELIXIR](https://elixir-europe.org/), E
 One of the goals of ELIXIR is to train research scientists to better use available computational infrastructures to address critical research questions. 
 This requires access both to face-to-face training opportunities and to disparate training materials and resources, currently dispersed across Europe.
 
-## Searching for training resources in TeSS
-
-Training resources (both events and materials) may be searched in TeSS in several ways. 
-If you are on the main page of TeSS, a general search can be performed based on keywords, which will return separate lists of events and materials. 
-
-Alternatively, events or materials can be searched for independently of each other. 
-This second approach allows more precise filtering on several parameters (e.g., event type, country, and target audience) alone or in combination.
-
-
-```{admonition} See also guidance from the ELIXIR Training Platform
-:class: seealso
-* [Searching in TeSS](https://elixir-europe-training.github.io/ELIXIR-TrP-TeSS/chapters/chapter_01/)
-```

TeSS_docs/search/searching.md

@@ -0,0 +1,50 @@
+# Searching for training resources
+
+## Getting started searching in TeSS
+
+Training resources (both events and materials) may be searched in TeSS in several ways.
+
+::::{grid} 1 2 2 2
+:gutter: 3
+
+:::{grid-item-card}
+{fas}`magnifying-glass;sd-text-secondary` **General search**
+^^^
+If you are on the main page of TeSS, a general search can be performed based on keywords, which will return separate lists of events and materials.
+:::
+:::{grid-item-card}
+{fas}`filter;sd-text-secondary` **Browsing and filtered search**
+^^^
+Use the tabs at the top of the page to browse events or materials separately then perform a more advanced search. 
+:::
+::::
+
+The second approach allows more precise filtering on several parameters (such as event type, country, and target audience), alone or in combination. You can also search for content providers, users and other types of training.
+
+
+## General search
+
+To perform a general search:
+
+1. In the top menu, click 'Home'.
+2. Click in the big search box in the centre of the screen and enter your query.
+3. Click the magnifying lens (search) button to the right or press {kbd}`Enter`.
+4. The search results are displayed in tabs for each type of result. These may include events, materials, content providers, learning paths, workflows, users, collections (depending on the search).
+
+## Browsing and filtered search
+
+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.
+  - 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.
+
+Descriptions of the filters can be found on the [Definitions](../overview/definitions) page.
+
+```{admonition} See also guidance from the ELIXIR Training Platform
+:class: seealso
+* [Searching in TeSS](https://elixir-europe-training.github.io/ELIXIR-TrP-TeSS/chapters/chapter_01/)
+```