Please help me with document extraction.

[Max TenEyck Woodbury]

On 02/28/2011 11:34 AM, André Hentschel wrote:
> Am 28.02.2011 17:20, schrieb Max TenEyck Woodbury:
>>> I think the idea of building upon the existing "documentation" somewhere else
>>> has a better chance than the "deal on the 100"
>>>
>> Frankly, I believe embedded documentation is the way to go. It is _not_
>> a panacea, but it is better than trying to maintain a separate set of
>> functional documentation. I have seen cases where it worked. Not great
>> but OK. I tried the separate document approach and got _very_
>> frustrated, and _no_one_ was really interested.
>
> Yeah, so let's see how interested people will be in the new aproach.
> (Also OK might not be enough for Wine)
>
Hmm.

First, it is _not_ a new approach. It has literally decades of
application. I first encountered it in the '80s and it was well
entrenched even then. Such people as D. Knuth have much to say on the
subject. It is not even new to Wine. There is a lot of embedded 
documentation already. It just is not being maintained.

Second, OK is better than nothing. I say it is OK because I have
actually used such a system. It is a pain to maintain, but the results
are usually very good. While the stuff I did never reached the public
(It got hung at the informal Q/A stage), other similar material was
sold at a profit and was generally rated as very good to excellent.
Again, the reason I call it OK is because of the amount of work
required.

Max