I.T. Discussion Community!
-Collapse +Expand
Tech Writer
Search Tech Writer Group:

Advanced
-Collapse +Expand Tech Writer Store

Prestwood eMagazine

June Edition
Subscribe now! It's Free!
Enter your email:

   ► KBRole-Based T...Technical Wr...   Print This     
  From the October 2008 Issue of Prestwood eMag
 
Tech Writer Technical Writing:
API documentation - documenting the program code
 
Posted 10 years ago on 10/1/2008 and updated 3/25/2009
Take Away:

Overview and tips for documenting an Application Programming Interface (API).

KB101312



Application Programming Interface (API) documentation provides information pertaining to the interfaces/classes/functions/objects used within the program module or for specific software application/product. Over a period of time, the developers/testers may not be able to remember all the API references. Hence, it is important to have this information stored and maintained in order to track changes between versions and able to manage this API information.

API documentation refers to documentation of the  software code. API includes interfaces, methods, classes and other user defined functions. It is important for developers to have this information being documented as they might not be able to remember all the API references and its related interfaces, classes, etc.

A technical writer working on API documentation needs to be well focussed towards the programming standards and understand the product architecture. The writer would be spending 50% of his time towarda analysis and understanding the code/APIs, 40% of the time will be spent towards documenting this code and 10% for the reviews.

As changes occurs with versions, service packs and new release over a period of time, it becomes necessary to update the existing documentation.

A writer needs to have this checklist in order to have a complete understanding of the ongoing API documentation:

  • Understand the software life cycle process
  • Glossary of the software terminologies
  • Product knowledge - architecture, specification
  • Programming language constructs
  • Definitions used in the programming language
  • Domain knowledge
  • End user requirements towards documentation
  • PM Process requirements and life cycle
  • Template/style guide for documentation

Comments

1 Comments.
Share a thought or comment...
First Comment
Comment 1 of 5

API documentation? We, essayhave academic company, technical writers, can deal with API documentation for your company software applications.

Posted 7 months ago

Comment 2 of 5

Google

Posted 7 months ago

Comment 3 of 5

Google

Posted 7 months ago

Comment 4 of 5

Now you must be thinking that not only wine will do and if aerator is there it will add more taste to it.  wine aerator

Posted 9 days ago

Latest Comment
Comment 5 of 5

 They offer another option to whirling, customary emptying and to Aldous (i.e. to sit tight for wine to relax). This classification developed in the Assembled States in or before 2007. bottle openers

Posted 4 days ago
 
Write a Comment...
...
Sign in...

If you are a member, Sign In. Or, you can Create a Free account now.


Anonymous Post (text-only, no HTML):

Enter your name and security key.

Your Name:
Security key = P1226A1
Enter key:
KB Post Contributed By Ramesh R:
Visit Profile

 KB Article #101312 Counter
7862
Since 10/1/2008
-
   Contact Us!
 
PrestwoodBoards.com was developed and is maintainted by me. Do you have a question or suggestion? Do you see a problem? Contact me now. My goal is to build an ad-free and spam-free source of I.T. information with many contributers (ok to promote your website/company in your bio). Yes, my company Prestwood IT Solutions is mentioned in my bio which shows with every post, but you can contribute and promote your pet project too!

1,055 People Online Now!!  
Sign In to see who's online now!  Not a member? Join now. It's free!
Show more stats...


©1995-2018 PrestwoodBoards  [Security & Privacy]
Professional IT Services: Coding | Websites | Computer Tech