improve documentation section 'how it works'