minor doc and test improvements
doc improvements (link between github and readthedocs)