# Reviewing Migrated and Refactored Documentation

**URL:** <https://forum.xwiki.org/t/reviewing-migrated-and-refactored-documentation/18592>\
**Category:** Development\
**Tags:** proposal, documentation\
**Created:** [June 11, 2026, 12:52pm UTC](https://forum.xwiki.org/t/reviewing-migrated-and-refactored-documentation/18592 "2026-06-11T12:52:29Z")\
**Posts on this page:** 1\
**Showing post:** 11

<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:** [August 7, 2026, 8:25am UTC](https://forum.xwiki.org/t/reviewing-migrated-and-refactored-documentation/18592/11 "2026-08-07T08:25:21Z")

</div>

> [@vmassol](#):
>
> What about the old doc pages linking to the new pages? Because AFAIR, it was supposed to be implemented with the info from this proposal. Or maybe I’m mixing with another proposal?

It’s inside this proposal: [Handling Fully Migrated Documentation Pages and Updating Backlinks](https://forum.xwiki.org/t/handling-fully-migrated-documentation-pages-and-updating-backlinks/18561). There are 2 options listed there:

- option 1- use redirect object to parent page of the topc, which is faster for us but less nice for the user since they would need to search for the exact piece of info they needed among the whole doc tree. But, we could say that in the new doc organization it’s easy to search and find what you are looking for and assume it’s not that much work for the readers.

- option 2- adding a new xobject for each new doc page with reference of the original page it comes from. But I just realized that this would still not solve the use case where the user has a bookmark to a heading of an old page. The new button with the link that would display all the new pages coming from the old page will still make the user search among all those pages. Actually, if we do the same display as in the Extension pages, e.g.: [https://www.xwiki.org/xwiki/bin/view/DocApp/Code/ExtensionLD?id=org.xwiki.platform:xwiki-platform-like-ui&name=“Like”](https://www.xwiki.org/xwiki/bin/view/DocApp/Code/ExtensionLD?id=org.xwiki.platform:xwiki-platform-like-ui&name=%22Like%22), it might be even harder than option 1, where we’d simply redirectly to the parent page and let users use the searchbox. (It’s one extra click to land on a doc page where there are 2 ways of searching).

WYT?

I can continue the discussion in that thread and make the poll there. Thanks!

---

_[View the full topic](https://forum.xwiki.org/t/reviewing-migrated-and-refactored-documentation/18592)._
