[TYPO3-doc] Small improvements to official documentation template

[Hermann Ragaller]

Francois,

I like the large left indent.  However I would suggest to let the 
headings start at the very left so they visually stand out of the text.

e.g.:

heading heading heading
	text text text text text text text text text text text text
	text text text text text text text text text text text text
	text text text text text text text text text text text text

May I suggest to have a look at the Oracle Manuals. I have worked with 
Oracle for years and I believe they produce excellent documentation. The 
layout is very readable and consistent across all their manuals. The 
concepts guide is a good example as it has a quite a few illustrations 
as well:

Direct link: 
http://www.oracle.com/pls/db112/to_pdf?pathname=server.112/e10713.pdf
Documentation homepage: http://www.oracle.com/pls/db112/homepage

It appears to me they are using something like docbook to produce the 
consistent look.

regards,
Hermann

Am 05.09.2010 23:10, schrieb François Suter:
> Hi all,
>
> After seeing some examples of other manuals I thought the call-out boxes
> in the new official documentation template could be improved. I've
> uploaded a modified PDF version of the template here:
>
> http://drp.ly/1FFw4h
>
> Please look at the call-out boxes and tell me what you think. The
> changes are:
>
> - no borders anymore
> - no background color
> - a large left indent is used instead to make them stand out
> - I also reduced the font size a bit, so that the text looks different too
>
> I also experimented a bit with frames, which would make it easier to use
> these call-out boxes (frames are easy to copy & paste), but I'm waiting
> on your feedback on the changes in design first, before creating the
> necessary frames.
>
> Other changes in this version:
>
> - as per Fabien's suggestion I added a sample table
> - I also added a sample bullet list, with the style from the extension
> manual template
>
> Cheers
>