Add manual registration

Author: PhilReedData

TeSS_docs/_toc.yml

@@ -24,10 +24,8 @@ parts:
     - file: content/intro-content
     - file: content/auto
       sections:
-      - file: content/auto-events
-      - file: content/auto-materials
-      - file: content/auto-workflows
-      - file: content/auto-schemas
+      - file: content/structured-data-types
+      - file: content/sources
     - file: content/manual
       sections:
       - file: content/manual-events-materials

TeSS_docs/content/auto.md

@@ -1,3 +1,7 @@
 # Automatic content registration
+
+TeSS features several options for automatically "harvesting" resources from external sources.
+This can be helpful if you are maintaining a large collection of events and materials that changes frequently.
+
 ```{tableofcontents}
 ```

TeSS_docs/content/learning-paths.md

@@ -1 +1,15 @@
-# Learning paths
+# Learning paths in TeSS
+
+## What is a learning path?
+
+A learning path is a pathway that guides learners through a set of modules (courses/materials) to be undertaken progressively (from lower- to higher-order thinking skills) to acquire the desired knowledge and skills on a subject by the end of the pathway.
+
+## Editorial process for Learning Paths in TeSS
+There are several roles associated with learning paths in general:
+
+- Author: Individuals and organisations involved in the preparation, creation or presentation of the published work.
+- Contributor: Individuals and organisations that contributed to the published work but are not authors.
+- Collaborator: An individual who has been granted editing rights to a material, topic or learning path by the individual (owner) who created it.
+- Curator: An individual who has been granted permission to create a learning path in TeSS while following their community’s editorial process.
+- Owner: An individual who has created a material, topic or learning path in TeSS.
+

TeSS_docs/content/manual-events-materials.md

@@ -1 +1,34 @@
-# Manually add events and materials
+# Manually add events and materials
+
+Resources may be added manually to TeSS.
+
+To do so, first [register for a free account](../accounts/user). Members of academic institutions may be able to log-in via LS-Login.
+
+Once registered and logged in, the 'Register event' and 'Register material' buttons will become visible on the events and materials tabs.
+
+## Manually register training materials
+
+To register a training material:
+
+1. In the top menu, click ‘Materials’.
+2. Click the button 'Register training material'.
+3. Complete the fields (required fields are marked with an asterisk) then click the  'Register Material' button.
+
+
+## Manually register events
+
+To register an event:
+
+1. In the top menu, click ‘Events’.
+2. Click the buttom 'Register event'.
+3. Complete the fields (required fields are marked with an asterisk) then click the  'Register Event' button.
+
+Alternatively, you can clone a previous event or training material. View the existing material and click the 'Clone' button at the top-right. 
+
+## Associate materials with a content provider
+
+Training materials and events may be associated to one content provider. 
+Content providers are entities (such as academic institutions, non-profit organisations, portals) that provide training materials
+
+1. To do so, first [register a content provider](../accounts/provider).
+2. When creating or editing any training material or event, select your content provider in the relevant field. 

TeSS_docs/content/sources.md

@@ -0,0 +1,13 @@
+# Sources
+
+Owners and editors of content providers in TeSS can register and manage Sources to be automatically ingested. A source consists of a URL for TeSS to fetch, and an "ingestion method" - which hints to TeSS how the contents of the URL should be processed.
+
+Once registered, a source will need to be approved by an administrator before it is active, but can be tested to see exactly what metadata TeSS can extract from the source.
+
+To register a source, click the "Sources" tab on your content provider page, or if you have not yet registered a content provider, see our page [Provider account creation](../accounts/provider).
+
+Currently available user-managed ingestion methods:
+
+- Bioschemas
+
+For other methods, please [contact us](https://tess.elixir-europe.org/about/us#contact) to discuss how to register your content automatically in TeSS. 

TeSS_docs/content/structured-data-types.md

@@ -0,0 +1,72 @@
+# Structured data types
+
+To register resources in TeSS automatically, we need to be able to extract data from target sources reliably. 
+To this end, it is helpful if the data is structured according to some kind of standard format.
+
+The following are examples of the kinds of structured data that TeSS can work with.
+
+If your website currently includes no structured data, and you’d like your resources added to TeSS, we recommend using [Bioschemas](http://bioschemas.org/) to structure your site.
+
+
+
+::::{grid} 1 1 1 1
+:gutter: 3
+
+:::{grid-item-card}
+{fas}`atom;sd-text-secondary` **Schema .org / Bioschemas**
+^^^
+Schema.org is a project run by a consortium of search engines. Schema.org has created an extensive library of schemas that web-masters can use to explicitly mark-up their websites content in order to improve search engine visibility and interoperability.
+
+Bioschemas is an initiative to supplement the work of schema.org to help improve the findability of online resources in the life sciences.
+
+The two main activities of Bioschemas are:
+- Proposing new types and properties to Schema.org to allow for the description of life science resources.
+- Defining usage profiles over the Schema.org types that identify the essential properties to use in describing a resource.
+
+TeSS supports the following Bioschemas profiles:
+
+for events that are courses
+- [CourseInstance](https://bioschemas.org/profiles/CourseInstance/1.0-RELEASE)
+- [Course](https://bioschemas.org/profiles/Course/1.0-RELEASE)
+
+for other events
+- [Event](https://bioschemas.org/profiles/Event/0.2-DRAFT-2019_06_14)
+
+for training materials
+- [TrainingMaterial](https://bioschemas.org/profiles/TrainingMaterial/1.0-RELEASE)
+:::
+
+
+:::{grid-item-card}
+{fas}`laptop-code;sd-text-secondary` **Sitemaps**
+^^^
+
+To help search engines (and TeSS) discover all the pages on a site that have Bioschemas markup, a [sitemap](https://developers.google.com/search/docs/crawling-indexing/sitemaps/overview) should be used. Sitemaps are basically a directory listing of all the pages on your site.
+
+Sitemaps are a well-established standard, and there should be sitemap libraries and plugins available for whichever software you are using to provide your site.
+:::
+
+
+:::{grid-item-card}
+{fas}`plug;sd-text-secondary` **API**
+^^^
+Application Programming Interfaces, or APIs, typically have endpoint URLs that, when accessed, return data in a common exchange format, such as JSON.
+
+TeSS currently supports the APIs for:
+
+- [Eventbrite](https://eventbrite.com/) - for events
+- [Zenodo](https://zenodo.com/) - for materials
+- Other TeSS instances - for events
+:::
+
+
+:::{grid-item-card}
+{fas}`calendar-days;sd-text-secondary` **Calendar**
+^^^
+
+Many organisations use calendar applications to organise and display their events. These may be custom-made or, more likely, utilise applications like Google Calendar. Calendar applications maintain an underlying file for event storage and retrieval, typically in the iCal (.ics) format.
+
+TeSS can extract event descriptions, dates and locations from iCal files.
+:::
+
+::::