[TYPO3-mvc] Documentation

[Francois Suter]

Hi Jochen,

First of all let me say that although I expressed true feelings I have 
been rather clumsy at it. So I'm sorry for that.

> Simply because otherwise it would never happen. The publisher O'Reilly
> (and especially my reader) did a great job on motivating me to write
> this book (or better: my part of the book). We are getting a lot of high
> quality feedback.

Good reason.

> I am surprised that you see the book as "the first official Extbase
> documentation". It is neither the first piece of documentation written
> (see the wiki on forge), nor is it "official" in sense of "given by the
> TYPO3 Association".

OK, my fault for not searching enough. I agree that the notion of 
"official" is not very clear, but it's actually something I'm working on 
(we're having discussions in the documentation ML about what defines 
"official documentation"; and making good progress, actually it's on my 
todo list to contact Sebastian and you to define what could be "official 
documentation" for Extbase).

> If I browse to the documentation section on typo3.org, the first thing
> catching my eye is the "official TYPO3 commercial book". It was first
> published in 2004 by OpenSourcePress -- in German. One year later it was
> available in English (and that is the status the link is pointing to).
>
> Did Werner Altmann, René Fritz, and Daniel Hinderink write that book to
> make a lot of money? I don't think so. For fun? We'll have to ask them.
>
> Ok. Let's browse for some official documentation of pibase. Keep in mind
> that the initial commit of the traditional tslib_pibase was on October,
> 3rd 2003. That's what I have found on typo3.org:

I know that there are a lot of holes in the TYPO3 documentation. OTOH 
it's also incredibly rich because Kasper made huge efforts to write 
hundreds of pages of manuals.

I cannot guess what motivated Werner, René and Daniel to write the book. 
I would say the situation was different because they had an extensive 
documentation base to build on. I don't mean that it's silly to write a 
book. A lot of people want books and it's good that there should be 
some. They are both useful and help raise the profile of their 
respective projects (TYPO3 in our case).

My worry was that the effort to write this extbase book was detracting 
from having a freely available documentation. Obviously I was wrong and 
I'm actually quite glad to be wrong. Still I think the situation was far 
from clear, so I guess this discussion was necessary if maybe painful.

> I didn't try the TYPO3 Snippets. It is "Forbidden".

Huh?

> (I don't want to offend you either. I know you did a tremendous job on
> improving the core doc.)

No offence. As I already said my post was rather clumsy in retrospect so 
I fully understand that you might have felt pretty pissed about it.

> Extbase/Fluid was released 5 months ago and what I want to point out is,
> that there is a strange mindset of "delivery obligation" out there.

I guess it's because it was given a very high profile as being the 
bridge to v5 etc. There has been a lot of buzz about it and that has 
raised expectations. Plus I would say that since this represents a new 
way of coding TYPO3 extensions, the need for information is higher.

> Hopefully, I was able to clarify my intentions.

Yes you did. Thanks a lot for it and sorry again for having been so rough.

Cheers

-- 

Francois Suter
Cobweb Development Sarl - http://www.cobweb.ch