Annotating Eclipse Resources

In continuation of my last post, a small suggestion.

The Eclipse web site contains a rather large number of articles and resources, but it is rather difficult to see which version of Eclipse they pertain to. E.g. consider the article "Creating JFace Wizards". This is article is from 2002 and many readers will - at least initially - disregard it as being too old and likely not up-to-date. That is not the case, but how can you know that?

My sugestion is to add extra information to the article outline that lists the Eclipse versions for which this article is still relevant and if possible describe the level of "outdatedness" if case an article is not completely up-to-date.

In order to keep the extra information up-to-date, first the original author and then a volunteer will be asked to re-read the article and state the relevance for the new Eclipse release and possibly state the work needed to update the article. This way, we might also get a larger number of up-to-date sources on many of the more relevant Eclipse technologies which in turn will help out with the problems I outlines in my previous post.

1 comment:

Karsten Thoms said...

In principle a good idea. It is always hard to know if an old article is still relevant an up-to-date. The problem is that the authors must be reminded to review their article and therefore they must have the time and will to do that. Time for maintainance of documentation is always hard to get.