[Typo3-debian] Debian manual ready for comments/improvements and proofreading

[Michael Stucki]

Hi Steffen,

> First of all, I honor your attempt to provide a manual to install debian
> from scratch but I don't think this should be the intention of a Typo3
> specific documentation. As "hard as the part to install Debian itself"
> can be, there are a lot of docs out there in the debian world, which
> explain debian installation. Same with Apache, PHP, ... This is why I
> won't comment page 2 to 31.

Well, you might be right and I agree with you in most other cases but I
think it's very good to do this in case of a Debian manual, just for
showing interested users how easy it is to install TYPO3 with Debian on
their machine!

Of course there are other and - some might say - more detailed manuals. But
this document covers the _complete_ installation of such a system compiled
into one guide.

> Next, I did not have the time (yet) to check the content in detail.

Will you do that? Would be good to know, of course.

> Table of content:
> - Should contain less entries and be more structured.
> 
> for example:
> 1. Installation
> 1.1 System preparation
> 1.2 Apache
> 1.3 PHP
> 1.4 Typo3
> 1.4.1 Typo3-source
> 1.4.2 Typo3-site-installer
> ...

Makes sense.

> Screenshots:
> - Screenshots should make things more clear, but not replace needed
> text. How to copy+paste text in screendumps?

Yes, using some special code formatting like here [1] could be better than
screenshots in some cases. Lars, do you agree with that?

> - Printing the doc will consume lots of toner/ink (because of white on
> blue/black colors and big borders). Reduce size and maybe invert colors.

Maybe. If it's not too much work.

> - Explain the needed steps a bit more.
> 
> For example:
> 1.4.1 Typo3-source
> Now that your system is ready for installing Typo3, we use the Debian
> package management system to install the Typo3 sources.
> Therefore, pick an editor of your choice and add the following two lines
> to /etc/apt/sources.list. (Consider, that you normally need to be root
> to edit this file.)
>   deb http://typo3.sunsite.dk/software/debian/ ./
>   deb-src http://typo3.sunsite.dk/software/debian/ ./
> (...)

Yes. Feel free to help, maybe you or someone else can send some useful stuff
to Lars?

> - Choose different fonts for input text, descriptions ... Colorisation
> could help, too.

Good idea! However, the fonts are default for TYPO3 documents, it shouldn't
be changed.

> That's it for now. This week, I have few time to spend on typo3, but
> after that, I'll have a closer look on the content itself.

Good to know :-)

Regards - michael

[1] http://typo3.org/documentation/document-library/doc_inst_rh61/FreeType/
-- 
Want support? Please read the list rules first: http://typo3.org/1438.0.html