[svn.haxx.se] · SVN Dev · SVN Users · SVN Org · TSVN Dev · TSVN Users · Subclipse Dev · Subclipse Users · this month's index

Re: Wiki migration -- redirect from old wiki

From: Julian Foad <julianfoad_at_apache.org>
Date: Tue, 26 Jun 2018 14:40:20 +0100

Johan Corveleyn wrote on 2018-06-25:
> > Johan: what is the recipe/regex for converting PAGE[#FRAGMENT]? The PAGE part seems to be unchanged, at least in simple cases.
>
> Yes indeed, the PAGE part is unchanged. However, since pages can (and
> will) be renamed [...] we should redirect the old pages to the "Tiny link" of
> the new pages (which are in fact stable [1]).

Perhaps. The general solution I would recommend for all migrations is to put the simplest possible logic at the old (retired) location and implement everything else at the new location. In this case, that could be a redirect from the entire old base URL to the new base URL, keeping the rest of the URL unchanged.

Maintaining redirects from the old to the new names of renamed pages should be the responsibility of the new location, in an ideal world. Because it is not an issue unique to the migration, it exists for everyone linking to Confluence. Relying on the "tiny links" isn't really a solution, because it's unrealistic to assume everyone will always use them. (I don't often use them, myself.) Confluence, and every web content management system, should (in my opinion) provides a facility for redirecting old URLs to new ones. I haven't checked whether Confluence does.

To me, that strengthens the case for making only a very simple redirect of the base URL at the old location.

> > How/where do we configure a redirect from the wiki.a.o subdomain? Ask infra?
>
> I don't think we can automate / script this, because of the need to
> use those "tiny links" as target. We're only talking about ~100 pages,
> so my idea was to just do this manually: edit each page and change the
> content into "#REDIRECT <newurl>". That would even maintain the
> original history in the MoinMoin wiki (until it gets deleted someday).

> As for the #FRAGMENT: that's more difficult. [...]

I assumed the migration tool already implemented the required conversion, as I assumed it already converted intra-wiki links. But if not, or if it's too difficult to extract, ...

> [...] Unless someone has a really good idea on how to solve this in an
> elegant way, I would just ignore supporting the "old fragments" in old
> links. We'll redirect the user to the correct page, but we can't guide
> him to the correct section ... too bad.

... then I agree with that: just forget about fragments.

> > I see we already have some redirects from subversion.a.o/... configured in site/publish/.htaccess; I have just updated this one:
> >
> > - Redirect /wiki http://wiki.apache.org/subversion
> > + Redirect /wiki https://cwiki.apache.org/confluence/display/SVN
>
> Great.
>
> > So far we're just talking about simple redirects. It would be a whole step better if we could publish the new Wiki's pages as an overlay onto Subversion's own top-level URL namespace:
> >
> > https://subversion.apache.org/<PAGE>
> >
> > From a site design or information design perspective that presents a much better joined-up site, and changing the back-end from MoinMoin to Confluence or to/from plain HTML wouldn't force us to change the URLs in our web pages and source code and docs. Also, much of our web-page material would be easier to maintain using the wiki's editor than as raw HTML.
> >
> > Any idea where to start with that?
>
> I'm not sure if that's a good idea. Making the wiki pages available
> through url's that are part of our top-level namespace, yes, perhaps.
> But putting the entire website in the wiki? Feels a bit weird to me,

I didn't mean our entire web site, I meant the Wiki pages and "plain" web pages should share the same URL space so we can choose on a page-by-page basis which tool to create the page with.

For example, yesterday I was editing the "/roadmap.html" page in Vim and thinking this would be much easier if it was a Wiki page, not only for WYSIWYG editing but largely because it would help me create and maintain all the intra-wiki and wiki-to-Jira links to other pages.

> except perhaps for some specific pages (like the faq) ... though I'm
> not a website designer, so I may be wrong. Can't really put my finger
> on it, but I believe for the webpages themselves you might need more
> flexibility than what you get inside the wiki.

For some, certainly; for many, not.

> Maybe those ideas should be bounced off of some infra people, or
> people in other ASF communities.

I have been wondering where best to find ASF people interested in organizing project web sites and tools for project communication. There is much more I would be interested in discussing -- not least the evolution and better integration of mailing lists, mail archives, IRC, and IRC archives.

Maybe I will try dev_at_community.apache.org .

- Julian
Received on 2018-06-26 15:40:28 CEST

This is an archived mail posted to the Subversion Dev mailing list.