improving online documentation

[Phil Bull]

Hi Matt,

On Mon, 2007-04-30 at 10:17 +0100, Matthew East wrote:
[...]
> We need to distinguish here between two things. The first is using
> PhrasesLikeThese in the body of documentation, which is what you're
> describing, and which, you're right, is clearly confusing and difficult to
> read. We should encourage people to use easy to read link text (which is
> perfectly possible in MoinMoin).
> 
> What Phil mentioned in his original post, and what I was saying is not a
> significant issue, is the actual URL of the page looking odd. This is only
> problematic (in my opinion) where the PhraseLikeThis carries over to the
> actual page title (which is fixed in recent Moin versions which add spaces
> between the words). I don't think the actual URL is a big deal.

I don't mind the URL being joined up - at least it has some meaning and
isn't just a numerical article ID. However, I think that JoinedUpWords
shouldn't be shown anywhere that a link is presented in the body of the
document, such as the page heading or in links. It's confusing and looks
weird.

Is there any way to break up links by default? I seem to remember a user
preference somewhere which could do this, but it would be nice to do it
automatically for all users.

Thanks,

Phil

-- 
Phil Bull
http://www.launchpad.net/people/philbull