Skip to content

Taxonomy Tag Management How-to Documentation Added#1449

Merged
sarina merged 12 commits intoopenedx:mainfrom
thelmick-unicon:main
May 6, 2026
Merged

Taxonomy Tag Management How-to Documentation Added#1449
sarina merged 12 commits intoopenedx:mainfrom
thelmick-unicon:main

Conversation

@thelmick-unicon
Copy link
Copy Markdown
Contributor

Added both the .rst file and the images related to the .rst file for Taxonomy Tag Management

Created a guide for taxonomy tag management, including tag management instructions and validation rules.
@openedx-webhooks openedx-webhooks added the open-source-contribution PR author is not from Axim or 2U label May 5, 2026
@openedx-webhooks
Copy link
Copy Markdown

openedx-webhooks commented May 5, 2026

Thanks for the pull request, @thelmick-unicon!

This repository is currently maintained by @openedx/wg-maintenance-docs.openedx.org.

Once you've gone through the following steps feel free to tag them in a comment and let them know that your changes are ready for engineering review.

🔘 Get product approval

If you haven't already, check this list to see if your contribution needs to go through the product review process.

  • If it does, you'll need to submit a product proposal for your contribution, and have it reviewed by the Product Working Group.
    • This process (including the steps you'll need to take) is documented here.
  • If it doesn't, simply proceed with the next step.
🔘 Provide context

To help your reviewers and other members of the community understand the purpose and larger context of your changes, feel free to add as much of the following information to the PR description as you can:

  • Dependencies

    This PR must be merged before / after / at the same time as ...

  • Blockers

    This PR is waiting for OEP-1234 to be accepted.

  • Timeline information

    This PR must be merged by XX date because ...

  • Partner information

    This is for a course on edx.org.

  • Supporting documentation
  • Relevant Open edX discussion forum threads
🔘 Get a green build

If one or more checks are failing, continue working on your changes until this is no longer the case and your build turns green.

Details
Where can I find more information?

If you'd like to get more details on all aspects of the review process for open source pull requests (OSPRs), check out the following resources:

When can I expect my changes to be merged?

Our goal is to get community contributions seen and reviewed as efficiently as possible.

However, the amount of time that it takes to review and merge a PR can vary significantly based on factors such as:

  • The size and impact of the changes that it introduces
  • The need for product review
  • Maintenance status of the parent repository

💡 As a result it may take up to several weeks or months to complete a review and merge your PR.

Copy link
Copy Markdown
Contributor

@sarina sarina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Comment thread source/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.rst Outdated
Comment thread source/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.rst Outdated
Comment thread source/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.rst Outdated
Comment thread source/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.rst Outdated
Comment thread source/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.rst Outdated
thelmick-unicon and others added 6 commits May 5, 2026 13:00
Add link to manage_taxonomy_tags in advanced_features
…my_tags.rst

Co-authored-by: Sarina Canelake <sarina@axim.org>
…my_tags.rst

Co-authored-by: Sarina Canelake <sarina@axim.org>
Updated the guide to clarify the navigation to the Taxonomy Detail page and modified notification wording for consistency. Moved warning about deleting parent tags and their sub-tags.
@sarina
Copy link
Copy Markdown
Contributor

sarina commented May 6, 2026

Looks like the CLA check is passing 🎉

Once the build passes I'll take a final 👀

@sarina sarina moved this from Needs Triage to In Eng Review in Contributions May 6, 2026
@sarina
Copy link
Copy Markdown
Contributor

sarina commented May 6, 2026

This is great! If you're unfamiliar with readthedocs builds, you can click on the build check and navigate to the page to see it live :) https://docsopenedxorg--1449.org.readthedocs.build/en/1449/educators/how-tos/content-tagging-how-tos/manage_taxonomy_tags.html

My one final piece of feedback is that in the Parent Tag Aggregation section, the text doesn't match the screenshot. I think it would be helpful if they matched. I don't see in the screenshot an actual demonstration of parent tag aggregation - there's a (2) on String Instruments but I don't see any children.

image

Added images and descriptions for Taxonomy Tab, Overview Page, and Detail Page.
Updated taxonomy_tag_usage_count to reflext the examples in the how to
@thelmick-unicon
Copy link
Copy Markdown
Contributor Author

@sarina I've updated the screenshot to match the text for the Parent Tag Aggregation

Copy link
Copy Markdown
Contributor Author

@thelmick-unicon thelmick-unicon left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

All requested changes have been made.

@thelmick-unicon thelmick-unicon requested a review from sarina May 6, 2026 15:37
Copy link
Copy Markdown
Contributor

@sarina sarina left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks so much!

@sarina sarina merged commit f7dc6bb into openedx:main May 6, 2026
2 checks passed
@github-project-automation github-project-automation Bot moved this from In Eng Review to Done in Contributions May 6, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

open-source-contribution PR author is not from Axim or 2U

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

3 participants