binarycloud-dev

[binarycloud-dev] docs

[Alex B. <en...@tu...>]

hi all,

Anyone out there using a working docbook/xml setup?

If so, any headaches?

I'm looking at this stuff and while it is xml and cool, it's _really_
monolithic, and there don't appear to be any editors that understand it.

I would prefer not to have to write all documentation in DocBook by hand...
given that 90% of people want to view html and I can (don't spit) use a
visual editor for editing the docs to speed everything up.

In general, I want opinions:
    -How do you like your docs
    -Given that PHPDoc is generating both html and xml (though I've never
seen the PHPDoc xml), it it ok to say: "all documentation is html"
    -Does anyone crave PDF? (Docbook of course makes this possible, if
elegant.. assuming you can get through the nightmare of setting it all up.

I've checked out a copy of the phpdoc (php-documentation) tree and will go
over it to see how much of a pain in the a** this would all be :)

best,

-alex

Re: [binarycloud-dev] docs

[Alex B. <en...@tu...>]

> I've checked out a copy of the phpdoc (php-documentation) tree and will go
> over it to see how much of a pain in the a** this would all be :)

This is a massive bastard of a tree :)

it requires that you have fo and saxon or xalan installed, and there's about
10,000 files in here (ok slight exaggeration). I imagine the setup is
probably a little nightmarish.

I could get this all working, and in some organized, relatively simple &
easy to modify format... but it would still be a severe pain in the a** to
change the documentation as compared to html documents.

Unless there's a cool docbook editor for linux? :)

_a