Expanding the documentation with richer explanations and adding links wh...

...ere apropriate