Expanding the documentation with richer explanations and adding links where apropriate