[TYPO3-english] ext. manuals on typo3.org not accessible

[Philipp Gampe]

Hi François,

François Suter wrote:

> What is wrong, though, is that the TER should not have a link to a
> documentation that cannot be rendered. I'm not entirely sure, but I
> think it bases itself on a file provided by docs.typo3.org (at least I
> know we provide one, but I'm not sure if the TER uses it), so it may be
> our file that is wrong.

The link is rendered without further checking.

showAction in
https://git.typo3.org/TYPO3CMS/Extensions/terfe.git/blob/master:/Classes/Controller/ExtensionController.php#l219
calls getDocumentationLink which just checks the extension key, not the 
version.
https://git.typo3.org/TYPO3CMS/Extensions/terfe.git/blob/master:/Classes/Service/Documentation.php

Unfortunately the file
http://docs.typo3.org/typo3cms/extensions/manuals.json
just contains the extension keys present on the server and the last update 
timestamp. Therefore no further checking is possible.

If the file would provide all versions, then we could of course only render 
a link if the actual version is rendered.

There seem to be some extensions (e.g. gridelements) that do not have a 
latest or version. If this is fixed, maybe we could always link the TER to 
the stable version.
On the docs server, we should redirect all not found versions (directory 
does not exist on server) with a 303 status code. This should be simple to 
implement via .htaccess.

Maybe Martin can do something about this.

p.s.: It would be really helpful if we could create a vagrant clone (along 
with chef scripts for deployment), just like the t3o server, that can be 
used of offline testing an coding.
Maybe we can meet up with Martin (afaik he lives not too far away) and some 
guys from the server team that are familiar with chef to get the whole 
server setup strait. That would help a lot for casual contributor that want 
to hack new features to the docs server.

Best regards
-- 
Philipp Gampe – PGP-Key 0AD96065 – TYPO3 UG Bonn/Köln
Documentation – Active contributor TYPO3 CMS
TYPO3 .... inspiring people to share!