#35 Fix broken links and relative references

[carlosmonteagudoinbibo]

• This is another pass of polishing the documentation
• This time the fixes are related to broken links and relative references