I am looking for an solution to Synchronize Java code and its api documentation. When my team make some changes in Java code, I want that my documentation should automatically synchronized to the new code, if this is not possible than there might me some way by which whenever i read documentation, documentation can point that this code needs to be updated. Something like a plugin between documentation and eclipse.
We use Java with Eclipse and Maven.
In a team environment, I would strongly recommend enforcing documentation updates via the build process. There are lots of ways to do this: Ant tasks, Maven POM files, etc. The principle is the same, though, however you do it: Have the build process create/update the documentation automatically. Don't rely on people doing it manually, because they'll eventually forget when they're rushing to meet a deadline. And if classes/methods are missing Javadoc comments, have the build process fail, so you can't produce executables with incomplete documentation.