No Code Attached Yet
avatar brianteeman
brianteeman
13 Aug 2025

Reminder that for the release of j6 the help proxy server needs to be setup AND the helpTOC script needs to be run

avatar brianteeman brianteeman - open - 13 Aug 2025
avatar joomla-cms-bot joomla-cms-bot - change - 13 Aug 2025
Labels Added: No Code Attached Yet
avatar joomla-cms-bot joomla-cms-bot - labeled - 13 Aug 2025
avatar HermanPeeren
HermanPeeren - comment - 14 Aug 2025
  • Since some years the helpTOC script is not run anymore. Any changes to the TOC have been made manually since then.
  • Because we want to get rid of docs.joomla.org (the wiki) we are looking for alternative ways to serve them. But that will be done at the help proxy, so no need to change anything in the CMS (and hence it could even be done after the release of J6).
  • In the wiki we always copied all help pages under a new namespace for the new major release, and then updated the help pages plus made translations (in 8 other languages). Quite a lot of work, we rather don't spend on the wiki anymore. For Joomla 6 in the proxy server a redirect is made for all J6 help pages to the J5 equivalent. That is also why you see them now in the pre-releases.
  • This temporary fix is also possible because there are not many changes between the help screens for Joomla 5 and 6. It is buying us some time to come to a definitive solution.
avatar brianteeman
brianteeman - comment - 14 Aug 2025

Sorry that statement about the help toc not being run is factually incorrect.

avatar bembelimen
bembelimen - comment - 14 Aug 2025

See: #43250 + #43251

avatar HermanPeeren
HermanPeeren - comment - 14 Aug 2025
  • Where is that script used in the build process?
  • Why were there manual updates to toc.json?
  • How is it possible we have a TOC in the pre-releases of Joomla 6 when the Category:Help_screen_6.0 ( build/helpTOC.php line 99) does not exist in the wiki?
avatar HermanPeeren
HermanPeeren - comment - 14 Aug 2025

I see my mistake:

  • the script was probably "manually" called during the build process in J5.x, after which the toc.json was updated by the script (and not manually); but that resulted in a commit.
  • the script was not run in J6 pre-releases. That would probably not give any help-pages as a result.

Anyway: because we want to get rid of the wiki we have no plans to update the Help pages for Joomla 6 in the wiki. So we might not run helpTOC.php for that...

avatar brianteeman
brianteeman - comment - 14 Aug 2025

Yes it is always run manually to create the JSON. That's why I posted this reminder. I understand it's in the release making documentation but as that's not public and from past experience of the script not being run that's the exact reason for making the post.

avatar brianteeman
brianteeman - comment - 14 Aug 2025

Anyway: because we want to get rid of the wiki we have no plans to update the Help pages for Joomla 6 in the wiki. So we might not run helpTOC.php for that...

I'm wondering if you realise where the json is being used. It is used to generate the menu for the help system in the Joomla admin. If the wiki is not going to be updated/used then we need to decide what to do with the help menu. not the help buttons

avatar brianteeman brianteeman - close - 15 Aug 2025
avatar brianteeman brianteeman - change - 15 Aug 2025
Status New Closed
Closed_Date 0000-00-00 00:00:00 2025-08-15 16:05:23
Closed_By brianteeman

Add a Comment

Login with GitHub to post a comment