grammar attack + improve documentation