[xwiki-users] What is the best strategy to document multiple versions (of a software) with XWiki ?
Hi, I'm wondering how I should document multiple versions of a software with XWiki. 1) Each versions documentation should be accessible under a version name that is part of the url http://www.thesoftware.org/version1/Reference_page1 2) Current version should point (redirect ?) to the most recent version http://www.thesoftware.org/currentVersion/Reference_page1 (Note that I have left off any parts of the url requried by XWiki (bin ...) Its important that all pages of a version can be referenced as a permalink. I'm thinking to do it this way but I'm wondering if there are any side effects I haven't thought of: - Versions are space names - Create a new version by copying the space from the last version - Copying the space is done by exporting the xar, renaming the space to the new version, then importing the .xar to recreate the last version. Any changes in the new version shall not modify documents of the last version (incl. attachments) - Change 'DocumentNotFound' template of 'currentVersion' (in a way that needs investigation) that it redirects all page requests for the space 'currentVersion' to a configured version --- or --- - handle requests to 'currentVersion' in an upfront (Apache httpd) Proxy Server redirecting to a configured version Is this a reasonable approach to document multiple versions or do i miss something ? Any ideas welcome ! thanks Andreas
Hi Andreas, Thanks to share your ideas about this very interesting subject. Be careful when renaming the space in the xar : you have to rename the pages but also the space name possibly present in page links. The only drawback that I see in this approach is the high amount of space that it may require, especially if you keep the versions of the attachments. As each version is a space, it is easy to remove the right to update the pages of the old versions. Please keep us informed of your progresses. Regards, Maxime 2011/4/3 Andreas Hahn <ahahn@gmx.net>
Hi,
I'm wondering how I should document multiple versions of a software with XWiki.
1) Each versions documentation should be accessible under a version name that is part of the url http://www.thesoftware.org/version1/Reference_page1
2) Current version should point (redirect ?) to the most recent version http://www.thesoftware.org/currentVersion/Reference_page1
(Note that I have left off any parts of the url requried by XWiki (bin ...)
Its important that all pages of a version can be referenced as a permalink.
I'm thinking to do it this way but I'm wondering if there are any side effects I haven't thought of: - Versions are space names - Create a new version by copying the space from the last version - Copying the space is done by exporting the xar, renaming the space to the new version, then importing the .xar to recreate the last version. Any changes in the new version shall not modify documents of the last version (incl. attachments)
- Change 'DocumentNotFound' template of 'currentVersion' (in a way that needs investigation) that it redirects all page requests for the space 'currentVersion' to a configured version --- or --- - handle requests to 'currentVersion' in an upfront (Apache httpd) Proxy Server redirecting to a configured version
Is this a reasonable approach to document multiple versions or do i miss something ?
Any ideas welcome !
thanks Andreas
_______________________________________________ users mailing list users@xwiki.org http://lists.xwiki.org/mailman/listinfo/users
participants (2)
-
Andreas Hahn -
Le Génie