[Typo3-dev] Hey system extensions! Come back to the extension repository!! was: Re: indexed_search / EXT Rep?

[Robert Lemke]

Hi Michael

Michael Scharkow wrote:

>> The other point is: We do have to upload system extensions in order to
>> display the documentation.
> 
> Why? There's plenty of documentation that is *not* extension related. If
> we decide that -to the outside world- system extensions are not
> extensions anymore (=not in TER), why not have theit documentation in a
> different place, where we have MTB, TSbyExample, etc.? A lot of system
> extensions don't have docs anyway (or only embedded in -core docs).

Technically the MTB etc. are extensions as well. So following your
suggestion a possible solution would be to have an extension
"doc_indexed_search" containing the documentation for indexed_search.

What we can't do (and we actually decided against it in discussions with the
docteam at the last snowboard tour) is decoupling documentation from
extensions technically. We still need the container for distributing and
managing documentation.

> For me, this case gives another reason why we should decouple extensions
> from their documentation. This does *not* mean we shouldn't provide
> means for ext authors to easily upload and maintain their docs.

Currently the advantage of coupling documentation with extensions is that
you can alwasy read the documentation for each version, there's a direct
connection between them. We only have few documents which are not directly
related to a specific extension version.

Cheers,
robert

-- 
Robert Lemke
TYPO3 Association - Research & Development
Member of the board
http://association.typo3.org