added literal includes of the source code to the documentation
slight reordering of hint