Ron, No two API docs are exactly the same, but usually they're pretty simple. It helps if you've done a little programming or scripting. Here are a couple sites to get you going:http://api-writing.blogspot.com/ http://java.sun.com/j2se/javadoc/ http://qooxdoo.org/documentation/0.7/how_to_write_api_documentation Hope this helps, Sean Pollock Siemens PLM Software
> To: [email protected]> From: [EMAIL PROTECTED]> Subject: API > documentation with references to Javadocs documentation> Date: Tue, 13 May > 2008 10:46:53 -0400> > Hi:> I have a JavaDocs reference. My client has asked > me to write an API > document in Frame with references to the JavaDocs > documentation. The > goal of the document is to provide further explanation > and examples > along with a context for usage beyond what is provided in the > > JavaDocs. In addition, the client wants to provide documentation on > how > to use Web Services instead of a Java object.> > I've been a tech writer for > a long time, but I'm in new territory > here. I'm wondering if there is a > standard way to approach this (or > if we are covering new ground). Can > anyone point me to resources to > get me started.> > One thing I'm having > trouble with is deciding how much JavaDocs > information I should include in > the Frame reference and how much I > should simply provide links or > references to. If anyone has any ideas > on how I can started, I would greatly appreciate it.> > Thanks,> Ron> > Ron Miller> Freelance Technical Writing Since 1988> > email: [EMAIL PROTECTED]> blog: http://byronmiller.typepad.com> web: http://www.ronsmiller.com> > > > > _______________________________________________> > > You are currently subscribed to Framers as [EMAIL PROTECTED]> > Send list messages to [EMAIL PROTECTED]> > To unsubscribe send a blank email to > [EMAIL PROTECTED]> or visit http://lists.frameusers.com/mailman/options/framers/spolloc1%40hotmail.com> > Send administrative questions to [EMAIL PROTECTED] Visit> http://www.frameusers.com/ for more resources and info. _________________________________________________________________ Stay in touch when you're away with Windows Live Messenger. http://www.windowslive.com/messenger/overview.html?ocid=TXT_TAGLM_WL_Refresh_messenger_052008 _______________________________________________ You are currently subscribed to Framers as [EMAIL PROTECTED] Send list messages to [EMAIL PROTECTED] To unsubscribe send a blank email to [EMAIL PROTECTED] or visit http://lists.frameusers.com/mailman/options/framers/archive%40mail-archive.com Send administrative questions to [EMAIL PROTECTED] Visit http://www.frameusers.com/ for more resources and info.
