Creating a Cocoa Help Book
Creating a Cocoa Help Book
- Subject: Creating a Cocoa Help Book
- From: Jose Antonio Ortega <email@hidden>
- Date: Wed, 30 Mar 2005 04:12:08 +0200
Hello.
I'm developing a shareware Cocoa application, still in early stage. I
already have a well defined toolchain for all aspects of the product
lifecycle but one: the creation of the program's help book.
Creating good documentation is, IMHO, a must for our project, and I
would appreciate any advice on what editors and other tools are your
preferred ones. Do you write directly HTML, or use some kind of
documentation system like LaTeX or DocBook? Sophisticated HTML editors
seem a bit overkill, since Cocoa Help does not support CSS or
JavaScript (please, correct me if I am wrong); and there's also the
point that we'd like to have a nice, printable PDF manual in addition
to the online help (preferably derived from the some sources).
On the other hand, editors like Word or Pages seem also out of the
question, for we would have little control on the generated HTML and
(for Word) a binary, proprietary format precludes efficient versioning
and concurrent writing. Not to mention that Word gives me the shivers!
:-)
All things considered, right now I lean to LaTeX, but I am asking
because I've got the (possibly wrong) impression that it is not a
popular choice among you seasoned Mac developers.
Thanks for your time, and please feel free to send me RTFM if I'm
missing some obvious resource.
Cheers,
José Antonio.
Attachment:
smime.p7s
Description: S/MIME cryptographic signature
_______________________________________________
Do not post admin requests to the list. They will be ignored.
Cocoa-dev mailing list (email@hidden)
Help/Unsubscribe/Update your Subscription:
This email sent to email@hidden