DOC: Fix problems in the docs

Thanks @teravest & @josenavas