Thursday, April 25, 2013

Enhance Extdoc Plugin : Introduction


Short description: The current Extdoc view provides extended documentation on classes and methods which has been data mind from code. But there is no way for users to influence the documentation yet. The major goal of this project is to enhance Extdoc view such that user can involve for the documentation (that is users can create, annotate and rate contributions to the documentation of classes and methods.


Abstract
The current Extdoc view provides extended documentation on classes and methods which has been data mind from code. But there is no way for users to influence the documentation yet. The major goal of this project is to enhance Extdoc view such that user can involve for the documentation (that is users can create, annotate and rate contributions to the documentation of classes and methods.
Detailed Information
Writing documentation is one of those tasks that programmers are typically not really interested in. It is time-consuming, wearisome dull task which has almost no immediate rewards. So as a consequence, most of the times documentation is incomplete or out-dated.
But at the same time good and comprehensive documentation is critical for the success of a library or framework. There are tools which can generate documentation (Javadoc comments) by extracting the obvious information from the source code. But the thing is for an instant it may be seems like helpful and valuable but finally this kind of documentation will only pleases the project manager since it improves the source code to documentation ratio. But in the developers point of view these kind of documentation is less helpful and rather useless.
However there are many other resources out there such as tutorial sites, Code-search engines and code snippet repositories which offers valuable information about an API (how to use a certain API or deal with errors). The current Extended Documentation platform is exclusively developed to serve the purpose of aggregate this wide range of information sources available on the web into a single view in eclipse.
The figure below shows the current Extdoc view.


The existing view of Extension documentation is great. But as you can see, there are no user feedback components. Without that functionalities the Extdoc view is rather incomplete. So the proposed idea of the project is to enhance the Extdoc platform which enables the functionality for the users to involve in the documentation. The figure below is a mock-up screenshot of the user interface of Extdoc view after adding the functionalities.

There by clicking on the log in text user will be navigated to a log in window which will be like this.




There user can authenticate himself by providing his/her Google, Yahoo likewise ID. It will be openId based authentication. By successfully log in to the system user will be able navigated to the Extdoc view which the user interface will be like this.






There user have the privileges to edit/create, annotate and rate the existing documentation.

Deliverables
Final product deliverable will be the Extended documentation platform with a very solid restful API for commenting and editing API elements and a very tight editing integration into the IDE.
  • Users will be authenticated based on openId authentication.
  • OData protocol will be used for backend communication.
  • The database back end will be SQL-DB.