[TYPO3-doc] DocBook: first sample manual

[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"?

> 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.

> 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/

Cheers

-- 

Francois Suter
Cobweb Development Sarl - http://www.cobweb.ch