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.





6 comments:

  1. can you get a headache from alcohol withdrawal is a hallucinogenic drug. This means that when consumed, it causes the user to have unusual experiences such as hearing sounds, seeing illusions, and feeling things that are not actually there. A drug with an extensive history of both medicinal and recreational use, LSD use does not come without risks. An acid trip can last 12 hours or more, and when it goes wrong it can go terribly wrong. This substance is common at raves, parties, and music festivals, so knowing what acid looks like and understanding the risks is imperative, especially for young adults and teenagers.

    ReplyDelete
  2. The We Level Up FL restoril withdrawal emotional wellness community is an exceptionally particular, present day, forward-thinking office giving imaginative conduct recuperation treatment programs. Treatments happen in a serene manicured setting with open air unwinding regions offering restoration spaces. Giving science-based psychological wellness medicines intended for every customer and conveyed through profoundly customized individual consideration.

    ReplyDelete
  3. The California drug treatment stage is the initial phase in treating liquor addiction. Withdrawal indications normally die down inside around one to about fourteen days subsequent to beginning detox; be that as it may, this could take longer relying upon the seriousness of your Alcohol Use Disorder (AUD). From that point, you will actually want to zero in on different parts of the recuperation cycle, like various exercises, treatments, advising meetings, and backing choices.

    ReplyDelete
  4. We Level Up tx inpatient addiction treatment offers top-tier addiction treatment detox using evidence-based therapy along with secondary dual diagnosis programs.

    ReplyDelete
  5. Dweeb'S Lair: Enhance Extdoc Plugin : Introduction >>>>> Download Now

    >>>>> Download Full

    Dweeb'S Lair: Enhance Extdoc Plugin : Introduction >>>>> Download LINK

    >>>>> Download Now

    Dweeb'S Lair: Enhance Extdoc Plugin : Introduction >>>>> Download Full

    >>>>> Download LINK yH

    ReplyDelete
  6. Fantastic! I have gained a much better understanding of the issue after reading this excellent piece. AirServer

    ReplyDelete