# Make the Help Application point to the new documentation

**URL:** <https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978>\
**Category:** Development\
**Tags:** proposal, xwikiorg\
**Created:** [October 14, 2026, 2:54pm UTC](https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978 "2026-10-14T14:54:25Z")\
**Posts on this page:** 4\
**Page:** 1

<div class="post-metadata">

**Author:** ![elenicojocariu](https://forum.xwiki.org/letter_avatar_proxy/v4/letter/e/b9e5f3/32.png) [@elenicojocariu](https://forum.xwiki.org/u/elenicojocariu)\
**Post date:** [October 14, 2026, 2:54pm UTC](https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978/1 "2026-10-14T14:54:25Z")

</div>

Hello,

**Context** : While working on the [proposal about where to list all macros, UIXPs, etc and missing XClasses in the DocApp](https://forum.xwiki.org/t/where-to-list-all-macros-uixps-etc-and-missing-xclasses-in-the-docapp/18924), I came across this page: [Macros](https://www.xwiki.org/xwiki/bin/view/Help/Macros/) and discovered it comes from the [Help Application](https://github.com/elenicojocariu/xwiki-platform/tree/master/xwiki-platform-core/xwiki-platform-help).

The [Help page](https://www.xwiki.org/xwiki/bin/view/Help/) still sends users to the old Documentation space. For example, clicking on any [“Learn more” button](https://www.xwiki.org/xwiki/bin/view/Help/) takes you to the old docs, most of the links link now lead to a “This content has moved” page or a redirect.

As found in the code, the Help Application links are hardcoded in the Help pages, for example here: ([xwiki-platform/xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/Help/Templates/WebHome.xml at master · elenicojocariu/xwiki-platform · GitHub](https://github.com/elenicojocariu/xwiki-platform/blob/master/xwiki-platform-core/xwiki-platform-help/xwiki-platform-help-ui/src/main/resources/Help/Templates/WebHome.xml)).

The Help App is not a special case. Anyone who saved a URL to an old documentation page, or any other place that use the URL instead of page reference, has the same problem of arriving on empty pages with links. A redirect to a single page doesn’t work well either, because one old page is now usually split into several new pages, so the redirect can’t know which one the reader needs.

However, I think the Help Application should be updated to ship direct links to the new content, so it is actually useful for users and up to date.

## Proposal

I can start updating the links myself. Right now, it is possible that some of them point to pages that are not converted to the new documentation yet, but we are close to having all the targets. So I suggest we only release the updated app once all the links are up to date.

### Pages in the Help Application

I’d keep these pages as they are, because I find them very useful, and only update their links:

- [Help](https://www.xwiki.org/xwiki/bin/view/Help/)
  - [Applications](https://www.xwiki.org/xwiki/bin/view/Help/Applications/)
    - [Attachments](https://www.xwiki.org/xwiki/bin/view/Help/Applications/?viewer=attachments)
    - [Movies](https://www.xwiki.org/xwiki/bin/view/Help/Applications/Movies/)
    - [Contributors](https://www.xwiki.org/xwiki/bin/view/Help/Applications/Contributors/)

  - [Macros](https://www.xwiki.org/xwiki/bin/view/Help/Macros/)
    - [Attachments](https://www.xwiki.org/xwiki/bin/view/Help/Macros/?viewer=attachments)
    - [Box](https://www.xwiki.org/xwiki/bin/view/Help/Macros/Box/)
    - [Chart](https://www.xwiki.org/xwiki/bin/view/Help/Macros/Chart/)
    - [Gallery](https://www.xwiki.org/xwiki/bin/view/Help/Macros/Gallery/)
    - [Table of Contents](https://www.xwiki.org/xwiki/bin/view/Help/Macros/ToC/)
    - [Notifications](https://www.xwiki.org/xwiki/bin/view/Help/Macros/Notifications/)
    - [Tree](https://www.xwiki.org/xwiki/bin/view/Help/Macros/Tree/)

- [Templates](https://www.xwiki.org/xwiki/bin/view/Help/Templates/)
- [Videos](https://www.xwiki.org/xwiki/bin/view/Help/Videos/)
- [History](https://www.xwiki.org/xwiki/bin/view/Help/History/)

#### Question: what do we do with the Videos page?

[Videos](https://www.xwiki.org/xwiki/bin/view/Help/Videos/) :The videos are old and don’t bring much value anymore. In the first one, for example, the UI has changed so much that you can’t really follow it. So I propose we drop the Videos page and stop pointing to it from the Help Application.

What do you think? Any other ideas?

Thanks!

---

<div class="post-metadata">

**Author:** ![vmassol](https://forum.xwiki.org/user_avatar/forum.xwiki.org/vmassol/32/6_2.png) [@vmassol](https://forum.xwiki.org/u/vmassol)\
**Post date:** [October 14, 2026, 8:31pm UTC](https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978/2 "2026-10-14T20:31:56Z")

</div>

> [@elenicojocariu](#):
>
> I can start updating the links myself. Right now, it is possible that some of them point to pages that are not converted to the new documentation yet, but we are close to having all the targets. So I suggest we only release the updated app once all the links are up to date.

Great. A PR would be appreciated 🙂

> [@elenicojocariu](#):
>
> [Videos](https://www.xwiki.org/xwiki/bin/view/Help/Videos/) :The videos are old and don’t bring much value anymore. In the first one, for example, the UI has changed so much that you can’t really follow it. So I propose we drop the Videos page and stop pointing to it from the Help Application.
> 
> What do you think? Any other ideas?

See [Handle videos in the help page](https://forum.xwiki.org/t/handle-videos-in-the-help-page/13220)

When [Handle videos in the help page](https://forum.xwiki.org/t/handle-videos-in-the-help-page/13220) was posted we didn’t have LLMs. I think we now have 2 options:

1. remove them
2. ask an LLM to create these videos for us by doing recordings. I don’t think that would be hard at all. The only question is whether our users would value that vs doc with text and images (basically cost vs advantage of doing it).

Thanks

---

<div class="post-metadata">

**Author:** ![elenicojocariu](https://forum.xwiki.org/letter_avatar_proxy/v4/letter/e/b9e5f3/32.png) [@elenicojocariu](https://forum.xwiki.org/u/elenicojocariu)\
**Post date:** [October 22, 2026, 3:30pm UTC](https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978/3 "2026-10-22T15:30:31Z")

</div>

Hi, thx for the feedback, I’m working on a PR for the links.

Regarding the videos, the doc pages have a lot of images now, so I think they cover the visual side well. I have to admit the videos are usually very appealing, but maybe they would be a better fit for XWiki SAS marketing materials rather than [xwiki.org](http://xwiki.org) or the Help app. So I’d be +1 to remove them from the Help app, wyt? Thanks!

---

<div class="post-metadata">

**Author:** ![elenicojocariu](https://forum.xwiki.org/letter_avatar_proxy/v4/letter/e/b9e5f3/32.png) [@elenicojocariu](https://forum.xwiki.org/u/elenicojocariu)\
**Post date:** [October 28, 2026, 9:58am UTC](https://forum.xwiki.org/t/make-the-help-application-point-to-the-new-documentation/18978/4 "2026-10-28T09:58:24Z")

</div>

Created [Loading...](https://jira.xwiki.org/browse/XWIKI-25603) and PR: [XWIKI-25603: Update the Help application links to point to the new documentation tree by elenicojocariu · Pull Request #7226 · xwiki/xwiki-platform · GitHub](https://github.com/xwiki/xwiki-platform/pull/7226) for updating links. Re the videos, I think I need more opinions, but this is my input:

> [@elenicojocariu](#):
>
> Regarding the videos, the doc pages have a lot of images now, so I think they cover the visual side well. I have to admit the videos are usually very appealing, but maybe they would be a better fit for XWiki SAS marketing materials rather than [xwiki.org](http://xwiki.org) or the Help app. So I’d be +1 to remove them from the Help app, wyt? Thanks!

Thanks!
