nrmay / tess Goto Github PK

• descriptions for dropdown items.
• resource field names > use hints such as Event, Duration.
• fix 'required' not showing on multi-input field.
• fix 'errors' not highlighted on multi-input and dropdown fields.
• fix country dropdown options.

Set up the personal environment to support the development and testing of changes.

Set up and deploy the application to the production environment.

How many people know that the University of Sydney is located in "Darlington"? /It is, the main campus actually spans Darlington and Camperdown!/

Might be better to show institution? Or some other "location" attribute?

We don't have counties in Australia - should probably be renamed states.

User Stories

UI/Look and feel

• As a user (trainer, researcher, research support professional), I would like search results presented in an easy to read layout, uncluttered and with a visual categorisation of search results.
• As a user (trainer, researcher, research support professional), I need the platform to be browser/operating system agnostic and mobile device friendly.

User Stories

Be identified by the registry to enable social networking

• As a user (trainer, researcher, research support professional), I want the National Training Registry to recognize me and others so that I can be connected with other users who I know, leave comments and be informed of training events that are of interest​ ​to​ ​me.

Receive recommendations about resources of interest to me

• As​ ​a​ ​user (researcher, research support professional),​ ​I​ ​want​ ​to​ ​receive​ ​recommendations​ ​about​ training events ​that​ are​ ​of​ ​potential​ ​interest to​ ​me​ ​and​ ​related​ ​to​ ​my​ ​work,​ ​so​ ​I​ ​increase​ ​opportunities for skills development​ ​in​ ​my​ ​field.

Discover registry training events of interest via aggregators or search services

• As a user (trainer, researcher, research support professional), I want to discover registry training events of interest via aggregators or other search​ ​services​ ​such​ ​as​ ​Google.

• review Event, Material, and Provider
• verify applicability of fields
• identify additional fields
• update dictionaries:
  • difficulty (materials)
  • eligibility (events)
  • event_type (events)

Implement first pass of role feature authorization based on the following spreadsheet: See Training Event/Material - schema mapping

• 'keep' - unchanged
• 'not using' - disable/hide
• mandatory/optional
• add new (except: instructors)
• enable dictionary switching
• changes (timezone, ...)

Although it is possible to add a venue when adding an event (only for face-to-face events), it is not possible to filter the events by venue. This seems like an important search/filter criteria when you are trying to find events to attend.

There's a number of other fields that capture location-related data e.g. organisation, city, county/state, contributor etc. We should review which of these we need.

User Stories

Access measures​ ​to​ ​assess impact​

• As​ the National Training Registry ​administrator/manager,​ ​I​ ​wish​ ​to​ ​use​ ​a​ ​variety​ ​of​ ​measures​ ​to​ ​assess impact​ ​including​ training ​registry​ ​metrics​ ​and​ ​incorporate​ ​them​ ​in​ ​my reports​ ​that​ ​help assess​ ​the value of the registry and impact​ ​of​ ​the​ ​training being provided.

See standard metrics about links to training events

• As​ ​a​ trainer or registry administrator,​ ​I​ ​want​ ​to​ ​know​ ​how​ ​many​ ​times​ ​a​ ​registry training event’s URL​ ​has​ ​been clicked on ​by​ ​others.

Current eligibility doesn't match our user stories. I could see eligibility

• Limited to host university only (maybe? list universities individually, but could get loooong)
• Limited to Intersect members
• Limited to QCIF members
• ...
• Open to all, first come/first serve
  ...

User stories:

• As a user (trainer), I want to login using my AAF authentication credentials to upload/edit details about my upcoming training events.
• As a user (trainer, researcher, research support professional), I can see all publicly available training events without using a login.

• Implement backup and restore scripts for DReSA.
• Test by backing up and restoring on TestTeSS.
• Implement cron jobs to backup weekly.

Create an initial draft architecture document for The Application, including:

• Purpose
• Stakeholders & Concerns
• Requirements:
  • functional
  • qualities
• Views
  • see: 4+1 Model

Review requirements to populate (scientific) topics field from multiple multi-level dictionaries, such as:

• FoR codes
• SEO codes
• Fair Sharing

It is only possible to filter events when browsing and not after searching. Can the filters be enabled for search results to help people refine their search?

Search results page

Browsing page

Finalize lists of;

• dictionaries
• resource fields
• categories (ie. optional/mandatory)

See Metadata for DReSA

Update register event page:

• re-order fields
• add hover text
• update dictionaries: eligibility & event types.

Update event model:

• add prerequisites
• add tech requirements
• change for_profit (boolean)
  • cost_basis (dictionary)
  • cost_value
  • cost_currency

Not updated:

• FoR/SEO code selector
• Instructors
• Is Part of (e.g. program, course)
• Level of Competancy

--- old spreadsheet ---
See Training Event/Material - schema mapping

Create a brand for the application to:

• make the deployed application distinct from ElixirTess
• establish an identity within the community

Branding includes:

• Header Layout
  • Site Title
  • Page Name
  • Logo & Icon
• Footer Layout
• Stylesheets: Colours & Fonts
• Static Text
  • Welcome
  • Sub-title
• About pages
  • What is TeSS
  • Registering Content in TeSS
  • Developers
  • About Us
  • Privacy

When browsing or searching for events the results are displayed as tiles and ordered left to right by date. This becomes difficult to read when there are many results (see screenshot from ELIXIR's TeSS). Can these be displayed as a list in chronological order instead?

Describe the bug
A clear and concise description of what the bug is.

To Reproduce
Steps to reproduce the behavior:

1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

Expected behavior
A clear and concise description of what you expected to happen.

Screenshots
If applicable, add screenshots to help explain your problem.

Desktop (please complete the following information):

• OS: [e.g. iOS]
• Browser [e.g. chrome, safari]
• Version [e.g. 22]

Smartphone (please complete the following information):

• Device: [e.g. iPhone6]
• OS: [e.g. iOS8.1]
• Browser [e.g. stock browser, safari]
• Version [e.g. 22]

Additional context
Add any other context about the problem here.

The current event types drop down doesn't provide enough options.

At a minimum we would need:

• Webinar
• Workshop
• Conference

Others might be

• Knowledge exchange
• Hackathon
• Drop-in session/hackyhour

• enable authentication via AAF
• display retrieved credentials

Create documentation to support the users and stakeholders of The Application.

User Stories:

Identify the​ ​associated​ ​persistent​ ​HTTP​ ​URI​ ​for​ a ​resource (??)

• As an API or crawler, when I encounter a landing page or web resource that describes a training event, I need to easily identify the​ ​associated​ ​persistent​ ​HTTP​ ​URI​ ​for​ ​the​ page/resource,​ ​so​ ​that​ ​I​ ​can​ ​retrieve​ ​it.

Quality of metadata (governance and standards)

• As a human or machine user, I want to easily and uniformly identify the metadata in a registry​ ​record,​ ​so​ ​that​ ​I​ ​can​ ​ascertain​ ​the​ ​relevance​ ​of​ ​the​ ​training event.
• As the Registry Administrator/Manager, I want to be able to provide users with consistent (metadata standard) and up-to-date information about training events.
• As a trainer, I want to understand best practice principles for entering information/metadata into the National Training Registry to ensure the metadata appropriately describes my training event, including relevant tags/keywords.
• As a trainer, when adding training event metadata (manually), I need data entry guidance/tips to ensure the metadata meets requirements.
• As a Registry Administrator/Manager, I can remove training “content” that is considered inappropriate.

Set up an environment to demonstrate changes before migration to production.

• Abstract text on home page to a default locale file.
• Create an alternate locale file
• enable switching between files.

• enable voting core features
• assignment of features by core roles

Set up an account and mechanism to pull to test changes pushed to the repository.

User Stories

Easily add ​training events (manually) into the National Training Registry/Calendar

• As​ ​a​ ​trainer,​ ​I​ ​want​ ​to​ add/edit ​my​ ​training events’ details​ ​with​ ​as​ ​little effort​ ​as​ ​possible​ ​into​ ​the​ ​registry​ ​platform.
• As a user (trainer), I can copy events so that I don’t have to recreate similar/new training events from scratch every time.

Easily add training events (automated via APIs or scapers) into the National Training Registry/Calendar

• As an administrator for other training registries/calendars, I want to be able to use the National Training Registry API or scraper to add training events as an automated process.

Easily add/embed registered training events into other websites

• As an administrator (Admin for other training registries/calendars, Registry Administrator/Manager, trainer), I want to be able to build widgets that allow registered events to be embedded on other websites.

Could we change the Scientific topics field to FoR codes and include a look up widget. Cardinality + many or multiple, i.e. provide "add FoR" functionality

Not sure if this one belongs in the bug category?

Operations - I'm not really sure what this relates to? Do we need it in our list of metadata fields?

There is a timezone field but it's free text and far away from the date/time of the event

User Stories

Access the metadata in my registry in real time through an API

• As a Registry administrator/manager, I want to be able to access the metadata in the National Training Registry in real time through an API (or scraper) in order to build views or services on other related platforms.

Search

Search functionality for users

• As a user (trainer, researcher, research support professional), I need search results that are relevant and based on search terms (relevance ranking), with most relevant results on the 1st page.
• As a user (trainer, researcher, research support professional), I would like to be able to search efficiently with Advanced Search functionality. ??
• As a user (trainer, researcher, research support professional), I would like to be able to search efficiently using Regular Expressions (include, exclude words etc) or Boolean search functionality.
• As a user (trainer, researcher, research support professional), when searching I would like to be able to easily report broken links.
• As a user (trainer, researcher, research support professional), I would like to have some auto suggest functionality to enable efficient searching.
• As a user (trainer, researcher, research support professional), I would like to have some functionality around tolerance for misspelling to enable efficient searching.
• As a user (trainer, researcher, research support professional), I would like to have some options for whole or partial search terms to enable efficient searching.
• As an institutional executive manager (funder of institutional training), I want to be able to track the training provided by my institution as well as others.
• As​ ​a​ ​user (researcher, research support professional), I want to be able to see all training events within my field/area of interest provided by my institution.

Filtering search for training events

• As a user (trainer, researcher, research support professional), I want to be able to filter my training event results to narrow the list to events that are of interest to me. Filter by:
  • Person (trainer)
  • Timeline
  • Training provider organisation
  • Search terms, keywords, categories, topic
  • Order by date (e.g. recent date)
  • Location / online
  • Cost
  • Other??

Abstract text from the following pages:

• Events
• Materials
• Providers
• About
• Registering Content
• Developers
• About Us
• Privacy
• Footer

• AAF Authentication required register
• Roles that can be requested
• Authorization/rejection process

Enable/Disable major features based on site settings. Initial feature states are as follows:
❌ e-Learnings
✔️ Events
✔️ Materials
❌ Nodes
❌ Packages
✔️ Providers
❌ Workflows

Provide documentation to support the ongoing maintenance of the The Application

• enable translation/adaptation

Might be useful to also consider including the following metadata fields - these don't appear to be currently accommodated:

• Instructor (thinking that this field could then be used to pull out trainers for the trainer registry - also good to include particularly for trainers wishing to make contact with other trainers in their area of expertise and interest)
• Prerequisites
• Registration details - ability to provide a link to the event in a registration platform, e.g. Eventbrite
• Learning outcomes/objectives

Review the ElixirTeSS text and amend as required for DReSA.
Text mapping can be found in: DReSA Text Mapping

Create a demo deployment of TeSS, with a minimal ATRaC branding, for sharing with the Australian community.

User Stories

• As a Registry Administrator/Manager, I would like to be able to perform platform software updates to ensure ongoing viability of the platform.