Adding content curation documentation by kennethrioja · Pull Request #36 · ElixirTeSS/docs

kennethrioja · 2026-10-05T13:24:36Z

As discussed in the dev's meeting on Wed Sep 30, 2026. This describes ElixirTeSS/TeSS#1382 for users

PhilReedData

I've not run locally yet but from reviewing on GitHub.com, I have made some stylistic suggestions to be consistent with other pages.

PhilReedData · 2026-10-05T13:28:04Z

+
+Ask your TeSS administrator if the `material_under_admin_approval` or `event_under_admin_approval` features are enabled.
+
+To see if your TeSS instance is supporting this feature, if you [manually register](./manual.md) a training material or event, the message *"This material/event will need to be approved by an administrator before being public"* is shown on the top of the form like the following screenshot:


Suggested change

To see if your TeSS instance is supporting this feature, if you [manually register](./manual.md) a training material or event, the message *"This material/event will need to be approved by an administrator before being public"* is shown on the top of the form like the following screenshot:

To see if your TeSS instance is supporting this feature, if you [manually register](./manual) a training material or event, the message *'This material/event will need to be approved by an administrator before being public'* is shown on the top of the form like the following screenshot:

Hyperlinks work in production and development environments if we exclude the file extensions in the links. (Maybe what you have written works on production too, but this suggested change makes the format of links consistent.)

Also, I am putting in single quotes when we reference text on screen, across all the docs.

PhilReedData · 2026-10-05T13:29:37Z

+
+## How training resources are curated in TeSS?
+
+When [prerequisites](#prerequisites) are met, any added training material or event (either [manually](./manual.md) or [automatically](./auto.md)) will be **by default** subject to verification and thus, not publicly shown in your TeSS instance. Your resource will be marked with an `Approval status` set to `Requested`, as shown below:


Suggested change

When [prerequisites](#prerequisites) are met, any added training material or event (either [manually](./manual.md) or [automatically](./auto.md)) will be **by default** subject to verification and thus, not publicly shown in your TeSS instance. Your resource will be marked with an `Approval status` set to `Requested`, as shown below:

When [prerequisites](#prerequisites) are met, any added training material or event (either [manually](./manual) or [automatically](./auto)) will be **by default** subject to verification and thus, not publicly shown in your TeSS instance. Your resource will be marked with an 'Approval status' set to 'Requested', as shown below:

PhilReedData · 2026-10-05T13:32:06Z

+
+*Curators* can then have access to a dashboard to review the newly registered resources by accessing the `your-tess-instance-website.org/curate/resources` page, which can be also found by clicking on the dropdown menu of the user profile on the top-right of the page once logged in > "Curate resources".
+
+In the dashboard, *curators* can filter resources by Type (material, event), User, [Provider](../accounts/provider.md), [Space](../spaces/intro-spaces.md), and Approval Status. `Approve All Filtered` and `Reject All Filtered` buttons can be found at the bottom of the page to allow approval or rejection of the filtered resources. For example, if you have a new Content Provider adding thousands of already curated materials, you can filter the list by their name and approve them all in a few clicks only.


Suggested change

In the dashboard, *curators* can filter resources by Type (material, event), User, [Provider](../accounts/provider.md), [Space](../spaces/intro-spaces.md), and Approval Status. `Approve All Filtered` and `Reject All Filtered` buttons can be found at the bottom of the page to allow approval or rejection of the filtered resources. For example, if you have a new Content Provider adding thousands of already curated materials, you can filter the list by their name and approve them all in a few clicks only.

In the dashboard, *curators* can filter resources by Type (material, event), User, [Provider](../accounts/provider), [Space](../spaces/intro-spaces), and Approval Status. 'Approve All Filtered' and 'Reject All Filtered' buttons can be found at the bottom of the page to allow approval or rejection of the filtered resources. For example, if you have a new Content Provider adding thousands of already curated materials, you can filter the list by their name and approve them all in a few clicks only.

PhilReedData · 2026-10-05T13:33:08Z

+
+![Information about a material that needs curation](../images/content/material_alert_new.png)
+
+## How training resources are curated in TeSS?


Suggested change

## How training resources are curated in TeSS?

## How are training resources curated in TeSS?

Phrasing as a question if we keep the question mark... or remove the question mark.

PhilReedData · 2026-10-05T13:37:29Z

+
+![A material with requested view](../images/content/material_requested_view.png)
+
+Once a resource is registered or ingested, the curation/verification can be made by `administrators`,`curators` or `space administrators`, which are specific TeSS user roles (generally speaking, *curators*). Space administrators can only see resources from their space.


Suggested change

Once a resource is registered or ingested, the curation/verification can be made by `administrators`,`curators` or `space administrators`, which are specific TeSS user roles (generally speaking, *curators*). Space administrators can only see resources from their space.

Once a resource is registered or ingested, the curation/verification can be made by 'administrators', 'curators' or 'space administrators', which are specific TeSS user roles (generally speaking, *curators*). Space administrators can only see resources from their space.

PhilReedData · 2026-10-05T13:37:47Z

+
+Once a resource is registered or ingested, the curation/verification can be made by `administrators`,`curators` or `space administrators`, which are specific TeSS user roles (generally speaking, *curators*). Space administrators can only see resources from their space.
+
+*Curators* can then have access to a dashboard to review the newly registered resources by accessing the `your-tess-instance-website.org/curate/resources` page, which can be also found by clicking on the dropdown menu of the user profile on the top-right of the page once logged in > "Curate resources".


Suggested change

*Curators* can then have access to a dashboard to review the newly registered resources by accessing the `your-tess-instance-website.org/curate/resources` page, which can be also found by clicking on the dropdown menu of the user profile on the top-right of the page once logged in > "Curate resources".

*Curators* can then have access to a dashboard to review the newly registered resources by accessing the `your-tess-instance-website.org/curate/resources` page, which can be also found by clicking on the dropdown menu of the user profile on the top-right of the page once logged in > 'Curate resources'.

PhilReedData · 2026-10-05T13:38:29Z

+
+## How to revoke the approval status of a resource?
+
+A *curator* may have misclicked the `Approve` button, they may come back to their decision by editing the resource manually, scroll down, and change the `Approval status` field to `Requested`.


Suggested change

A *curator* may have misclicked the `Approve` button, they may come back to their decision by editing the resource manually, scroll down, and change the `Approval status` field to `Requested`.

A *curator* may have misclicked the 'Approve' button, they may come back to their decision by editing the resource manually, scroll down, and change the 'Approval status' field to 'Requested'.

feat(approval): added content curation docs

56dc79d

PhilReedData requested changes Oct 5, 2026

View reviewed changes

chore(approval): apply Phil's suggested changes from ElixirTeSS#36

972f854

kennethrioja closed this Oct 9, 2026

kennethrioja deleted the approval branch October 9, 2026 15:08

Navigation Menu

Repository navigation

Adding content curation documentation - #36

Adding content curation documentation#36
kennethrioja wants to merge 2 commits into
ElixirTeSS:mainfrom
hep-training:approval

kennethrioja commented Oct 5, 2026

Uh oh!

PhilReedData left a comment

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

PhilReedData Oct 5, 2026

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants


		Ask your TeSS administrator if the `material_under_admin_approval` or `event_under_admin_approval` features are enabled.

		To see if your TeSS instance is supporting this feature, if you [manually register](./manual.md) a training material or event, the message "This material/event will need to be approved by an administrator before being public" is shown on the top of the form like the following screenshot:


		## How training resources are curated in TeSS?

		When [prerequisites](#prerequisites) are met, any added training material or event (either [manually](./manual.md) or [automatically](./auto.md)) will be by default subject to verification and thus, not publicly shown in your TeSS instance. Your resource will be marked with an `Approval status` set to `Requested`, as shown below:


		Curators can then have access to a dashboard to review the newly registered resources by accessing the `your-tess-instance-website.org/curate/resources` page, which can be also found by clicking on the dropdown menu of the user profile on the top-right of the page once logged in > "Curate resources".

		In the dashboard, curators can filter resources by Type (material, event), User, [Provider](../accounts/provider.md), [Space](../spaces/intro-spaces.md), and Approval Status. `Approve All Filtered` and `Reject All Filtered` buttons can be found at the bottom of the page to allow approval or rejection of the filtered resources. For example, if you have a new Content Provider adding thousands of already curated materials, you can filter the list by their name and approve them all in a few clicks only.


		![Information about a material that needs curation](../images/content/material_alert_new.png)

		## How training resources are curated in TeSS?

	## How training resources are curated in TeSS?
	## How are training resources curated in TeSS?


		![A material with requested view](../images/content/material_requested_view.png)

		Once a resource is registered or ingested, the curation/verification can be made by `administrators`,`curators` or `space administrators`, which are specific TeSS user roles (generally speaking, curators). Space administrators can only see resources from their space.


		## How to revoke the approval status of a resource?

		A curator may have misclicked the `Approve` button, they may come back to their decision by editing the resource manually, scroll down, and change the `Approval status` field to `Requested`.

	A curator may have misclicked the `Approve` button, they may come back to their decision by editing the resource manually, scroll down, and change the `Approval status` field to `Requested`.
	A curator may have misclicked the 'Approve' button, they may come back to their decision by editing the resource manually, scroll down, and change the 'Approval status' field to 'Requested'.

Conversation

kennethrioja commented Oct 5, 2026

Uh oh!

PhilReedData left a comment

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

PhilReedData Oct 5, 2026

Choose a reason for hiding this comment

Uh oh!

Reviewers

Uh oh!

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants