Re: Documentation Wish - was Re: AppKit source available as reference?
Re: Documentation Wish - was Re: AppKit source available as reference?
- Subject: Re: Documentation Wish - was Re: AppKit source available as reference?
- From: David Remahl <email@hidden>
- Date: Sun, 1 Jul 2001 23:26:11 +0200
Would anyone care to identify "good" documentation ? Would anyone
care to
identify a more consistent or clearer framework ?
good documentation is cross-referenced, and makes use of hyperlinks:
when a function returns an object that's also documented, a link is
provided to jump to that object's documentation. ditho for the
parameters,...
I suggest that you don't need to go back to a framework's list of
classes everytime you want to consult another class' documentation.
Frames are a good option for this (why not get inspiration from
javadoc's format ?).
Oh please no. JavaDoc just sucks. and I'd much rather have a
method of getting at my documentation without reverting to the lowest
common denominator of using a web browser
What I'd really like to see is Apple encode all their
documentation using XML. That way it would be easily parsed into other
formats.
Ideally what I want is something that has the ability to jump to
different parts based on what you click on, and only show portions that
are relevant (i.e, not load the entire document and scroll to a
location).
often I don't want to read the documentation, but just want to get
the params that I need to pass (or review spelling). All of this would
be much easier with a documentation tool accessing the docs in XML.
_______________________________________________
Excellent idea! I too hate HTML doc (especially if / when I have to use
Help Viewer.app which is the lamest piece of soft to come out of Apple
ever...In OmniWeb it is almost enjoyable, but the scrolling is annoying).
That would also solve the problem with Project Builder integration,
since someone could create a service-style viewer for the docu, or apple
could easily handicraft their own indexed one.
/ regards, David