Skip to content

Conversation

@kurtaking
Copy link
Member

@kurtaking kurtaking commented Nov 28, 2025

Hey, I just made a Pull Request!

We are consolidating all functionality into the admin portal. The previous version provides individual pages for each of these entry points which have now been removed.

As the plugin's adoption grew, more requests to hide UI components based on permissions came in. This decision was made to simplify the plugin and reduce the complexity of the codebase. It also provides a more consistent UX for admin operations and allows for more flexibility in the future.

Breaking Changes

Removed Routes

The following route references have been removed and are no longer available:

  • announcementCreateRouteRef - Use announcementAdminRouteRef instead
  • announcementEditRouteRef - Use announcementAdminRouteRef instead
  • categoriesListRouteRef - Categories are now managed within the Admin Portal
  • tagsListRouteRef - Tags are now managed within the Admin Portal

Removed Components

The following components have been removed:

  • CreateAnnouncementPage - Replaced by AdminPortal with Announcements tab
  • EditAnnouncementPage - Replaced by AdminPortal with Announcements tab
  • CategoriesPage - Replaced by AdminPortal with Categories tab
  • TagsPage - Replaced by AdminPortal with Tags tab
  • NewCategoryDialog - Category creation is now handled inline within the Categories tab
  • NewTagDialog - Tag creation is now handled inline within the Tags tab

Component Reorganization

Admin-related components have been reorganized into feature-specific directories:

  • Admin/AnnouncementsContent/ - Contains announcement management components
  • Admin/CategoriesContent/ - Contains category management components
  • Admin/TagsContent/ - Contains tag management components

Benefits

  • Single entry point for all admin operations (/announcements/admin)
  • Less code to maintain - removed duplicate page components
  • Reduction in code duplication - shared form logic consolidated
  • Less code to migrate to @backstage/ui and the new frontend system
  • Improved UX with tabbed interface for related admin operations
  • Better permission handling - all admin operations gated through one portal

Highlights

  • The button to create a new announcement has been removed from the announcements page. This button is now only available in the admin portal.
  • The context menu has been updated to only include a link to the admin portal. Links to the individual pages for categories and tags have been removed.
  • All admin operations (create/edit announcements, manage categories, manage tags) are now accessible through a unified tabbed interface in the Admin Portal.
  • The AnnouncementsCard component now links to the admin portal instead of the create page.

✔️ Checklist

  • A changeset describing the change and affected packages. (more info)
  • Added or updated documentation
  • Tests for new functionality and regression tests for bug fixes
  • Screenshots attached (for UI changes)
  • All your commits have a Signed-off-by line in the message. (more info)

@kurtaking kurtaking self-assigned this Nov 28, 2025
@backstage-service backstage-service added the workspace/announcements Used to tag announcements workspace isses and pull requests label Nov 28, 2025
@backstage-goalie
Copy link
Contributor

backstage-goalie bot commented Nov 28, 2025

Changed Packages

Package Name Package Path Changeset Bump Current Version
@backstage-community/plugin-announcements workspaces/announcements/plugins/announcements major v0.17.0

Removes all individual pages for creating and edits announcements,
categories, and tags.

Users must use the admin portal component in order to manage
announcements, categories, and tags.

Signed-off-by: Kurt King <[email protected]>
@kurtaking kurtaking force-pushed the deprecate-individual-manage-pages branch from 9085945 to 7492b3a Compare November 28, 2025 01:00
Signed-off-by: Kurt King <[email protected]>
@backstage-goalie
Copy link
Contributor

Thanks for the contribution!
All commits need to be DCO signed before they are reviewed. Please refer to the the DCO section in CONTRIBUTING.md or the DCO status for more info.

This reverts commit 7b557c2.

Signed-off-by: Kurt King <[email protected]>
Signed-off-by: Kurt King <[email protected]>
@kurtaking kurtaking force-pushed the deprecate-individual-manage-pages branch from dfe8593 to 9186480 Compare November 28, 2025 15:48
@kurtaking kurtaking marked this pull request as ready for review November 28, 2025 15:49
@kurtaking kurtaking requested review from a team and gaelgoth as code owners November 28, 2025 15:49
@kurtaking kurtaking requested a review from 04kash November 28, 2025 15:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

workspace/announcements Used to tag announcements workspace isses and pull requests

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants