update documentation; some small typos in framework