Added reference to example source file.
Documentation work.

Added window hints table, added detailed description of all public
functions, added project brief and added missing language to transition
guide.