some stlyistic changes to documentation