[Typo3-typo3org] Fwd: Broken Link In "Inside TYPO3"

[Kasper Skårhøj]

> typo3.org/documentation/document-library/templavoila/What_does_it_do-f9aaec
>d761/
>
> Therefore I suggest we just leave the current scheme and create a mapping
> from old to new URLs in some way. I don't think that it's a good idea if we
> keep the hash for example.

"What does it do" is probably unique within templavoila manual. However the 
lookup table feature of realurl couldn't make the alias dependant on a former 
value like "templavoila" and therefore had to make the alias unique across 
ALL documentation. With a user function there is a chance you can actually do 
this better I guess.

>
> I strongly suggest to drop that mapping. As you said: it's a huge task
> trying to keep that updated and most people didn't. Furthermore I created
> the TER 2 in way that no further action is necessary after uploading an
> extension and it would be great if could stay like it.

OK, persuaded. But I just want to point out that my mapping-idea was in fact 
made to do the best possible job of keeping old URLs functional :-)


>
> And now comes the part with the version number: I still think we should
> have the version number in the URL, because *the document of a certain
> version never changes*! If you link to a certain version of the document
> you can always be sure that the chapter and sections exist.

of course, but most people will enjoy to link to the most _current_version of 
a document and therefore you must map "current" to the current document. 
Otherwise everyone will have to constantly update their links...

And furthermore; You don't know what day and time you decide to skip the 
archive of old documents because the amounts of data exceeds the abilities of 
the software running typo3.org - this would just repeat history for us. In 
other words; I like the idea of an archive as long as it doesn't come at the 
expense of the search and display of most recent documents - and if it does 
some day it must be possible to just shut it down.

>
> To provide backwards compatibility and offer another way of accessing the
> documents, we could agree on this rule: If the version parameter (0.1.0) is
> not a valid version number, it is assumed that this is the chapter title of
> the most recent version.

I think people should make links to ".../current/..." most of the time. Eg. 
"Here is a link to GIFBUILDER" - and of course everyone wants to see the 
CURRENT attributes, not some that are 2 years old.
If version 0.1.0 is removed, yes, we can fall back to the most current version 
of course.

In fact I'm slightly worried about having a prominent archive at TYPO3.org:
For some documents it is nice to have "Inside TYPO3" for version 3.7.0, 3.8.0 
and 3.9.0 etc. of the core. But for most other documents the most recent 
version is all people will care about. if the archive constantly pushes the 
choice of version into peoples fases it will just add the our current 
documentation-confusion. Lets hide the archive far away. Possible on another 
website. Less noise.


>
> These two links would link to the same place provided that "0.1.0" is the
> latest version of the document:
>
> typo3.org/documentation/document-library/extension-manuals/view/templavoila
>/0.1.0/introduction/what-does-it-do
> typo3.org/documentation/document-library/extension-manuals/view/templavoila
>/introduction/what-does-it-do

Good.


>
> Finally I have to create a plugin or RealURL configuration which accepts
> this URL:
>
> typo3.org/documentation/document-library/templavoila/What_does_it_do-f9aaec
>d761/
>
> Displays a message that the URL has changed and points to the new location.
> We can also send some HTTP header which tells the search enginges that the
> document location has changed.

it is no problem making links to most popular sections in documentation. Just 
added such a redirect feature in realurl anyways. But it will not be all 2000 
links probably because they will be set manually. However, my version of 
realurl also logs which "404 urls" are most visited and thus you can simply 
remap them to the position you like.


>
> So, what do you think? Would
>
> typo3.org/documentation/document-library/extension-manuals/view/templavoila
>/0.1.0/introduction/what-does-it-do
>
> be a solution which we could live with for a very long time?
>

Yes,  if the links exclude "0.1.0" by default so search engines and people 
bookmarking links are blind to the version they link to.

- kasper



> Cheers,
> robert

-- 
- kasper

-----------------
Think future, not feature