brutasse docs: adapt to reality