[TYPO3-doc] DocBook: sample reference file

[Stephan Petzl]

Am 04.03.11 09:39, schrieb François Suter:
> Hi Stephan,
>
> I think we have some misunderstandings, but I guess I have trouble
> spelling out my vision ;-)
>
No - I think I got your arguments, and I understand them. I have 
targeted my concerns and I think you understood them too.
So if you still want to stick to docbook that's ok for me- you are the 
documentation professional :)

>
> Now I don't expect that we will use those HTML files straightaway,
> neither for "normal" manuals nor for references. On the contrary I would
> expect the content of the HTML files included as content inside the page
> being viewed on typo3.org. This would make it perfectly possible to
> attach comments, examples, etc. to the content being viewed. Of course,
> the URL should be as helpful as possible.
>
> To achieve this we will probably need to have some table of contents
> stored in the database. I don't know in detail yet how this could work,
me neither- that's what's bothering me

> but it certainly does not seem impossible. It may be quite some work,
> but - as I said already - it's a one-time job and it's worth investing
> some effort in it so that we have a documentation that rocks.
>
you are right. but as far as I see we really haven't too much man-power 
here. If we were some more developers, I would be 120% on your side.

> How does that sound?
>
> BTW the 2011 TYPO3 Association budget includes a budget I requested for
> the DocBook migration project. I will communicate more about this in the
> near future, but my idea is that - although most of us contribute
> voluntarily - there may be some tasks which require more work or may be
> less exciting and that's when we could use that budget to actually pay
> for someone's work.
>
NICE :)

-- 
Best Regards
Stephan Petzl
http://www.ajado.com