[TYPO3-mvc] Quickstart documentation

[franz ripfel]

Hi,

well, that looks like a conflict to me. Luckily we have svn to help with  
conflicts and merge properly :)
I am probably more on Sebastians side.

In my opinion it is the best learning effect
a) to see a running example and
b) to try to adapt what i can see there to another Domain (thats a good  
check if i understood the basics)

Its quite different to understand (or at least think to understand) an  
existing working exampe and to adapt it to another but similar problem.
We have some experience about that with our internship-people.

The main manual would then be the in-depth-view of how its really working  
with probably more sophisticated Domain wishes to see the possiblities.


Conclusions:
Well, for now i will make a quite short and abstract step-by-step guide  
for the suggested example to use and test it with our guys here and place  
it into the quickstart if we have some good results with it here  
internally.
Beside i will try to improve the current quickstep explanations for  
blog_example, there is quite some room for improvements :)

keep going, Extbase is going to be great fun!
Franz

> Hi Franz,
>
> I had a look at what you wrote so far, and I really like it :-)
>
>  > I would prefer to have the "write your own extension" guide in the
>  > manual. Let's concentrate to have a good step-by-step quickstart  
> manual
>  > first. It would be confusing to have two different Domains inside the
>  > quickstart manual.
>
> Seems I have a conflicting opinion here ;) I think part of the  
> quickstart is helping people to learn a certain system without going too  
> much into the details - thus, I think a "walkthrough" developing an  
> extension would be very helpful. For understanding, it is much more  
> helpful if you have a quickstart part which guides you through all  
> steps, from creating the directory structure to a full-fledged  
> extension, explaining the problems along the way and the solutions we  
> provide.
>
> So, I see the first Part Franz wrote more as an introduction to get  
> people interested - while people will actually learn how to use Extbase  
> in the second part of the Quickstart. And then, they'll later use the  
> Manual to look up how specific parts work when they have the big picture.
>
> Currently I see the manual more as a reference whose job is more to  
> describe the different parts of the system really in detail, while the  
> quickstart will be didactically a lot more helpful if it provides an  
> example "from scratch".
>
>  > I would also prefer to stick to one Example Domain (A BlogApplication)
>  > for the whole documentation. In rare cases (where the domain model of
>  > a Blog isn't applicable) we could take a peek at another domain.
>
> actually I think people start to get used to the blog example, and maybe  
> it is helpful to have another domain for a walkthrough like the one  
> Franz pointed out. Maybe we should just try it out?
>
> I'm not sure if we currently mean the same, @Jochen, but just phrase it  
> differently ;-)
>
> Greets and thanks for all your work,
> Sebastian



-- 
Franz Ripfel, A.BE.ZET
http://www.abezet.de