xwikisas / xwiki-pro-macros

XWiki rendering macros useful when migrating content from Confluence
GNU Lesser General Public License v2.1
3 stars 12 forks source link

Move all generic macros to XWiki/Macros location #315

Open snazare opened 1 month ago

snazare commented 1 month ago

Following #277 and #287 here is the current structure of Pro Macros :

I. In the Confluence/Macros location:

  1. Confluence bridge macros prefixed with 'confluence_' and not used as standalone macros after the migration: [in pro-macros-confluence-bridges module]
  1. Confluence macros not prefixed, that can be used standalone after migration: [in pro-macros-ui module]
  1. Legacy Confluence bridges that were not prefixed when created and that should not be used after the migration (we maintain them for backwards compatibility for users that migrated a while ago): [in pro-macros-confluence-bridges module]

II. In the XWiki/Macros location: [in pro-macros-ui module]

Proposal:

After gathering feedback from our users and considering the new organization of the macros in Confluence migration specific and generic, I would propose the following changes:

Macro New location New module Reason
content-report-table XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
contributors XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
excerpt XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
excerpt-include XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned. We need a documentation page in XWiki/Macros too.
expand XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
profile-picture XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
recently-updated XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.
userProfile XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned. We need a documentation page in XWiki/Macros too.
view-file XWiki/Macros   XWiki/Macros is a more appropriate location for generic pro macros compared to Confluence/Macros. If non Confluence-migration users install the generic Pro Macros module and see "Confluence" in their navigation they may be confused and concerned.