extended the documentation + fixed some links