From 802894dff2d7e1cd5d80f70b99c132140e6c7e31 Mon Sep 17 00:00:00 2001 From: Wendi Bacon <44605769+nomadscientist@users.noreply.github.com> Date: Fri, 20 Dec 2024 14:59:45 +0000 Subject: [PATCH 1/4] Create matrix bot FAQ --- topics/community/faqs/matrix_news_bot.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 topics/community/faqs/matrix_news_bot.md diff --git a/topics/community/faqs/matrix_news_bot.md b/topics/community/faqs/matrix_news_bot.md new file mode 100644 index 00000000000000..4baa2df1813252 --- /dev/null +++ b/topics/community/faqs/matrix_news_bot.md @@ -0,0 +1,16 @@ +--- +title: How do I add a news feed to a Matrix channel? +box_type: tip +layout: faq +contributors: [nomadscientist, hexylena] +--- + +1. You must be an *Admin* in the channel. Find this out by going to the channel and selecting **Room info** --> **People**, or clicking on the little circle images of people in a channel. Admins can make other admins. + +2. Go to **Room info** --> **Extensions** --> **Add extension** --> **Feeds** + +3. Under *Subscribe to a feed*, add a URL from this [GTN feeds listing]({% link feeds/index.md %}). Make sure that it ends in `.xml`. For example, `https://training.galaxyproject.org/training-material/topics/community/feed.xml` would provide updates on any community-tagged GTN materials into the Matrix channel. + +Details from Matrix are here: https://ems-docs.element.io/books/element-cloud-documentation/page/migrate-to-the-new-github-and-feeds-bots + +4. Provide a reasonable name, and then hit **Subscribe**! From 0496211177aed74c3dfa39df660bf7475740587e Mon Sep 17 00:00:00 2001 From: Wendi Bacon <44605769+nomadscientist@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:10:17 +0000 Subject: [PATCH 2/4] add template --- topics/community/faqs/matrix_news_bot.md | 6 +- .../tutorials/community_content/tutorial.md | 77 +++++++++++-------- 2 files changed, 47 insertions(+), 36 deletions(-) diff --git a/topics/community/faqs/matrix_news_bot.md b/topics/community/faqs/matrix_news_bot.md index 4baa2df1813252..6f8c26cc6e7321 100644 --- a/topics/community/faqs/matrix_news_bot.md +++ b/topics/community/faqs/matrix_news_bot.md @@ -11,6 +11,8 @@ contributors: [nomadscientist, hexylena] 3. Under *Subscribe to a feed*, add a URL from this [GTN feeds listing]({% link feeds/index.md %}). Make sure that it ends in `.xml`. For example, `https://training.galaxyproject.org/training-material/topics/community/feed.xml` would provide updates on any community-tagged GTN materials into the Matrix channel. -Details from Matrix are here: https://ems-docs.element.io/books/element-cloud-documentation/page/migrate-to-the-new-github-and-feeds-bots +4. Under *Template*, change the existing text to the following: `$LINK: $SUMMARY` + +5. Provide a reasonable name, and then hit **Subscribe**! -4. Provide a reasonable name, and then hit **Subscribe**! +Details from Matrix are here: https://ems-docs.element.io/books/element-cloud-documentation/page/migrate-to-the-new-github-and-feeds-bots diff --git a/topics/community/tutorials/community_content/tutorial.md b/topics/community/tutorials/community_content/tutorial.md index e27b61df5aeca7..62fb364ac5dfac 100644 --- a/topics/community/tutorials/community_content/tutorial.md +++ b/topics/community/tutorials/community_content/tutorial.md @@ -14,10 +14,10 @@ time_estimation: "30M" key_points: - "The GTN has worked hard to provide automated metrics and resources to highlight and acknowledge the efforts of communities and community leads" - "This only works if we contribute with effective tagging." +requirements: contributions: authorship: - nomadscientist - - shiltemann requirements: - type: "internal" @@ -51,25 +51,29 @@ To help topic maintainers to quickly recognise what materials need updating and > Go to your topic Maintainer Home > -> 1. Go to any GTN training topic of interest. -> 2. Scroll down past the tutorials, and click on the "Maintainer Home" button -> -> {% snippet topics/community/faqs/maintainer_home.md %} -> +> 1. Go to any training topic of interest. This will have the form +> ``` +> https://training.galaxyproject.org/training-material/topics/ +> ``` +> 2. Add a /maintainer to the end of the url. +> ``` +> https://training.galaxyproject.org/training-material/topics//maintainer +> ``` > 3. Explore the Maintainer Home! -> - For example, the [Single Cell Maintainer Home]({% link topics/single-cell/maintainer.md %}) > {: .hands_on} +{% snippet topics/community/faqs/topic_pages.md %} + You may instantly see some key information missing from tutorials, or how long its been since someone checked it! Time to update some materials! You can see an example from the Single-cell topic below: @@ -79,23 +83,25 @@ Where the **Maintainer Home** helps you sustain your community, the **Community > Go to your topic Community Home > -> 1. Go to any GTN training topic of interest. -> 2. Scroll down past the tutorials, and click on the "Community Home" button -> -> {% snippet topics/community/faqs/community_home.md %} -> -> 3. Explore the **Community Home**! -> - For example, the [Single Cell Community Home]({% link topics/single-cell/community.md %}) +> 1. Go to any training topic of interest. This will have the form +> ``` +> https://training.galaxyproject.org/training-material/topics/ +> ``` +> 2. Add a /community to the end of the url. +> ``` +> https://training.galaxyproject.org/training-material/topics//community +> ``` +> 3. Explore the Community Home! > {: .hands_on} You can see an example from the Single-cell topic below: @@ -105,24 +111,25 @@ Next up, you might want to know how many people are actually using your material > Go to your topic usage statistics > -> 1. Go to any GTN training topic of interest. -> 2. Scroll down past the tutorials, and click on the "Maintainer Home" button -> -> {% snippet topics/community/faqs/maintainer_home.md %} -> -> 3. Scroll down to the section "Statistics For Your Materials" -> 4. Explore the usage statistics! -> - For example, the [Single Cell Usage Statistics]({% link topics/single-cell/maintainer.md %}#statistics-for-your-materials) +> 1. Go to any training topic of interest. This will have the form +> ``` +> https://training.galaxyproject.org/training-material/topics/ +> ``` +> 2. Add a /community to the end of the url. +> ``` +> https://training.galaxyproject.org/training-material/topics//maintainer.html#statistics-for-your-materials +> ``` +> 3. Explore the usage statistics! > {: .hands_on} You can see an example from the Single-cell topic below. @@ -133,12 +140,14 @@ You can also embed news into your pages, subdomains/ Galaxy Labs, or even your M Follow this documentation to learn how: 1. [GTN Feeds]( {% link feeds/index.md %} ) -2. [Bot integration into matrix]( {% link news/2023/12/20/matrix-bots.md %} ) +2. Bot integration into matrix + +{% snippet topics/community/faqs/matrix_news_bot.md %} You can see an example from the Single-cell topic below.

News and Events

- + # Workflow search @@ -152,7 +161,7 @@ Follow this documentation to learn how: You can see an example from the Single-cell topic below.

Public workflows

- + # Galaxy Community Activities calendar From da9194b54c8370cd6c756237b51e4717d0355a15 Mon Sep 17 00:00:00 2001 From: Wendi Bacon <44605769+nomadscientist@users.noreply.github.com> Date: Fri, 20 Dec 2024 15:19:34 +0000 Subject: [PATCH 3/4] unclash --- .../tutorials/community_content/tutorial.md | 71 +++++++++---------- 1 file changed, 32 insertions(+), 39 deletions(-) diff --git a/topics/community/tutorials/community_content/tutorial.md b/topics/community/tutorials/community_content/tutorial.md index 62fb364ac5dfac..9902d0678c0ffb 100644 --- a/topics/community/tutorials/community_content/tutorial.md +++ b/topics/community/tutorials/community_content/tutorial.md @@ -14,10 +14,10 @@ time_estimation: "30M" key_points: - "The GTN has worked hard to provide automated metrics and resources to highlight and acknowledge the efforts of communities and community leads" - "This only works if we contribute with effective tagging." -requirements: contributions: authorship: - nomadscientist + - shiltemann requirements: - type: "internal" @@ -51,29 +51,25 @@ To help topic maintainers to quickly recognise what materials need updating and > Go to your topic Maintainer Home > -> 1. Go to any training topic of interest. This will have the form -> ``` -> https://training.galaxyproject.org/training-material/topics/ -> ``` -> 2. Add a /maintainer to the end of the url. -> ``` -> https://training.galaxyproject.org/training-material/topics//maintainer -> ``` +> 1. Go to any GTN training topic of interest. +> 2. Scroll down past the tutorials, and click on the "Maintainer Home" button +> +> {% snippet topics/community/faqs/maintainer_home.md %} +> > 3. Explore the Maintainer Home! +> - For example, the [Single Cell Maintainer Home]({% link topics/single-cell/maintainer.md %}) > {: .hands_on} -{% snippet topics/community/faqs/topic_pages.md %} - You may instantly see some key information missing from tutorials, or how long its been since someone checked it! Time to update some materials! You can see an example from the Single-cell topic below: @@ -83,25 +79,23 @@ Where the **Maintainer Home** helps you sustain your community, the **Community > Go to your topic Community Home > -> 1. Go to any training topic of interest. This will have the form -> ``` -> https://training.galaxyproject.org/training-material/topics/ -> ``` -> 2. Add a /community to the end of the url. -> ``` -> https://training.galaxyproject.org/training-material/topics//community -> ``` -> 3. Explore the Community Home! +> 1. Go to any GTN training topic of interest. +> 2. Scroll down past the tutorials, and click on the "Community Home" button +> +> {% snippet topics/community/faqs/community_home.md %} +> +> 3. Explore the **Community Home**! +> - For example, the [Single Cell Community Home]({% link topics/single-cell/community.md %}) > {: .hands_on} You can see an example from the Single-cell topic below: @@ -111,25 +105,24 @@ Next up, you might want to know how many people are actually using your material > Go to your topic usage statistics > -> 1. Go to any training topic of interest. This will have the form -> ``` -> https://training.galaxyproject.org/training-material/topics/ -> ``` -> 2. Add a /community to the end of the url. -> ``` -> https://training.galaxyproject.org/training-material/topics//maintainer.html#statistics-for-your-materials -> ``` -> 3. Explore the usage statistics! +> 1. Go to any GTN training topic of interest. +> 2. Scroll down past the tutorials, and click on the "Maintainer Home" button +> +> {% snippet topics/community/faqs/maintainer_home.md %} +> +> 3. Scroll down to the section "Statistics For Your Materials" +> 4. Explore the usage statistics! +> - For example, the [Single Cell Usage Statistics]({% link topics/single-cell/maintainer.md %}#statistics-for-your-materials) > {: .hands_on} You can see an example from the Single-cell topic below. @@ -161,7 +154,7 @@ Follow this documentation to learn how: You can see an example from the Single-cell topic below.

Public workflows

- + # Galaxy Community Activities calendar From a6d1e01b28b87dc6ecec371211bc37c9872cdc6f Mon Sep 17 00:00:00 2001 From: Saskia Hiltemann Date: Fri, 20 Dec 2024 16:48:37 +0100 Subject: [PATCH 4/4] Update topics/community/tutorials/community_content/tutorial.md --- topics/community/tutorials/community_content/tutorial.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/topics/community/tutorials/community_content/tutorial.md b/topics/community/tutorials/community_content/tutorial.md index 9902d0678c0ffb..03aab662f99681 100644 --- a/topics/community/tutorials/community_content/tutorial.md +++ b/topics/community/tutorials/community_content/tutorial.md @@ -140,7 +140,7 @@ Follow this documentation to learn how: You can see an example from the Single-cell topic below.

News and Events

- + # Workflow search