Document the Context class from the Core APIs properly

The Context class from the core APIs is not well documented. Usually one has to look for code snippets to understand how to use it. See http://platform.xwiki.org/xwiki/bin/view/DevGuide/API for the current status.