docs update: some typos and mistakes cleaned up