Bug 933324 - More documentation improvements;r=davehunt