[Typo3-documentation] Document guide

[Johannes Reichardt]

Ok, skip some of what i wrote ;)

http://wiki.typo3.org/index.php/Documentation_Guide

I just set it up.

Two things i noticed: First, newlines seem to be somewhat unpredictable 
- did someone expirience too?

Did somebode ever try hitting "ctrl +(-)" on the wiki? its wikied :)

- Johannes

>
>
>>
>> Hi all
>>
>> Johannes wrote
>> > Typo3 in a nutshell is just missing - the guide which directs
>> > you so i can follow every step, the guide which says
>> > "allright, you can do this and that with typo with this and
>> > that way, but the most common and future-compatible way is
>> > this and that"
>>
>> Why not start by making a new wiki page with your structure:
>>  http://wiki.typo3.org/index.php/Documentation guide
>>
>> Then I can put a link to it in the Shortcut section of the Main page. 
>> Why do I suggest this and not want to alter the existing wiki 
>> structure? Because:
>>
>> * I believe your suggestion is more a guideline than a basic overall 
>> documentation structure. And like you wrote, we need a guide to the 
>> Typo3 documentation.
>
>
> Well thats why i will not enter it, actually i wouldnt put it "just" 
> somewhere, once again some usability hidden somewhere in the *huge* 
> typo3 project but instead on the frontpage.
>
>> * We can visually see if the structure is useful. And when you fill 
>> it with real documents/links we can test in in real life.
>
>
> Ok thats a point. But why do we have to test it before we set it up? 
> Lets communicate it here and set it up afterwards - that way we have a 
> response and can improve it.
>
>>
>> * We also see that you really finish what you start and do not say 
>> "sorry, I have no time to finish this. (Sorry, I just had to... :-) 
>> :-) )
>
>
> Ok. Good point ;) - i tend to bark louder then i bite. But actually i 
> would love to see just *something* happen - right now i feel with this 
> list "oh great, i can talk now but hey what for?" - i made a 
> stylesheet someone didnt like. i said yeah, there is ONE color in the 
> body which could be changed. Simple problems i couldnt solve and 
> things that are a matter of taste i can´t completly decide. But 
> nothing happened. The style with the better heading sizes etc.. was 
> not set up, the whole group was not able to check it out - the 
> discussion is just between the two people who feel like checking out 
> that sheet. And if you finally (when?) set it up there will be still 
> someone unhappy. why not give room for improvement? you have to throw 
> a stone in the river so it gets rounder and rounder by time.
>
>> * In the future (when we have enought good documentation) we can 
>> probably switch the structures, so that we then aim at readers and 
>> the writers "goes into the background".
>>
>> What do you think? An acceptable compromise?
>
>
> No, its showing once again the typo3-problem in general. Focusing on 
> expirienced *coders* first, trying to make it compatible with newbies 
> afterwards. If expirienced people cant use an easy structure for 
> newbies, who will then?
>
> - Johannes
>
> _______________________________________________
> Typo3-project-documentation mailing list
> Typo3-project-documentation at lists.netfielders.de
> http://lists.netfielders.de/cgi-bin/mailman/listinfo/typo3-project-documentation 
>
>