[Typo3-documentation] 1 or 2 install docs?

[Peter Kindstr”m]

Hi everybody!
I start with the Installation structure issue:

> As far as I understood Kasper he'd like to have 1 documentation
> for the installation process. Although I understand Peter's
> preference of splitting it up into many different once I do see
> the advantage of having one single document.
> 
> There is a lot of redundant information with the installation
> process that is very similar to every operating system that will
> benefit to be combined and structure.

1. You could always refer to other documents. As the document 
looks today that is no problem, I think, but I have not read the 
Linux/Mac documents yet.

2. We have to think about the user - not about our selfs! Do you 
suggest one big document because _you_ think its better/easier 
or because _the_user_ benefits?
One big document for everything could be just too overwhelming 
for newbies, I think.

3. I think its harder to maintain one huge document in the long 
run - we have to let many people have access to the document, 
simply because no single person can be an expert of every part 
of it. And that could be harder to coordinate than many 
different documents with one editor/expert each ...?


> I'm thinking of owner and permission issues, safe-mode, symbolic
> links etc. I personally like to focus on the installation
> packages provided by Michael and Ingmar and go from there
> whereever more detailed information is needed. As it seems those
> packages are not always working for everyone. Furthermore if
> somebody wants to be up to date he probably like to upgrade Typo3
> by hand. I  see some work there too to get more into how to do
> that, especially how to install Typo3_core only once to make the
> upgrading life easier.

Looks like we are getting quite a large document here... How 
many pages are we talking about? Todays installation guide is 
already 25 pages and the other installation guides are 36 pages 
in total.

I really dont like the idea of an 50+ pages Installation manual 
to show to newbies. What does a newbie think when he/she see 
that the Installation of Typo3 requires 50+ pages? I myself 
would probably go for another CMS...  



Regards,
Peter Kindström  <peter.kindstrom at abc.se>