[TYPO3-doc] DocBook: first sample manual

[Michael Bakonyi]

Hi Francois,

Am 24.03.2011 um 16:38 schrieb François Suter:

> Hi,
> 
>>> Was that your question?
>> 
>> Kind of, yes. But especially for an example xml for EXT-developers I
>> would add some example headlines aswell. I guess it's possible to add
>> headlines like it's done with HTML, right? This often bothers me
>> while reading extension-manuals: the detailed structuring within a
>> chapter. Often headlines are just paras and therefore not visible as
>> headlines which makes reading / understanding the text a bit
>> difficult sometimes.
> 
> I'm still not sure I understand exactly what you mean. What do you mean
> with "headlines"?

Uhm ... like h1, h2 etc. in HTML.

> 
>> Yes, interpretations might vary for caution and important. I would
>> keep it simple and skip one. After thinking about it again I would
>> just keep important which can stand for warnings aswell.
> 
> Yes, maybe "important" is enough indeed.

Yep.

> 
>> Can you give an example for "Next steps"? Scenario as reader: I'm
>> finished with a tutorial so e.g. I've got a working T3-installation
>> now. What could be my next steps? Maybe I'd like to add some
>> extensions then within 'Next Steps" there could be a link to the
>> repos. I could play around with the config, then there could be a
>> link to the TSref-doc ... I can't imagine an example where "Further
>> resources" wouldn't be a better wording. But maybe it's too early in
>> the morning. ;)
> 
> http://typo3.org/documentation/document-library/tutorials/doc_tut_quickstart/1.0.0/view/1/12/

Okay for me this would be an example where "further resources" would (perfectly) fit but I don't want to keep harping about on issue.

Regards,
Michael