[Typo3-doc] Wiki people: who's on board now?

[Alex Heizer]

Hi Peter,


Peter Kindström wrote:

>Hi Virgil,
>  
>
>>>>Look at installation manuals for an example:
>>>>http://wiki.typo3.org/index.php/Getting_started
>>>>We have 15 different pages/documents about installing and
>>>>upgrading! It would not help much to make yet another one, would
>>>>it? Unless you delete some of the already existing one, of course.
>>>>        
>>>>
>>>Let's start with that example, then. Virgil, you want to take a crack at
>>>this one? :)
>>>      
>>>
>>Sure, why not :-) This weekend was a wash, I had other things going
>>on, hopefully I can work on TYPO3 stuff this week.
>>    
>>
Thanks, Virgil. I think this will help kickstart some of the 
consolidation, and be a good test for working out a process. If you can 
keep track of what worked and didn't while you do this, that kind of 
"meta" information can help us decide how best to do this in the future. 
I've worked on some similar projects in the past, but not with this much 
information and I never took notes. It would be good to have some 
process feedback for anyone wanting to help who doesn't have that much 
experience in document merging.

>
>May I /suggest/ the following?
>* Put Installation and Upgrade into separate documents, since
>people rarely do these things at the same time.
>* Make a separate document or an appendix for the stuff that is
>good to have, but normal not needed during a typical installation.
>* Work at the wiki (but on a separate page, perhaps?), then
>other people can help, add, correct and comment the work.
>* Look at:
>http://wiki.typo3.org/index.php/Talk:TYPO3_Installation_Basics
>
>
>And if you want some ideas for the structure of the documents:
>http://www.infolagret.se/typowiki/index.php/Basic_Upgrade
>http://www.infolagret.se/typowiki/index.php/Basic_Installation_Manual
>
>http://www.infolagret.se/typowiki/index.php/Basic_Installation_Appendix
>  
>
Sounds good to me. Off the top of my head, since there will be some 
cross-linking, if someone is doing an upgrade, then they have already 
installed it at some point. So maybe do the installation guide first. 
Then, if information is also needed in the upgrading guide that is more 
than just a couple of sentences, reference it and link to it from the 
installation guide. I can't imagine how much would need to be 
referenced, but just as a process, what do you think would be the best 
way to do it? Maybe just wait to see what information is there, I guess.

Thanks,
Alex