updated links and tweaked documentation