DOC (WIP): implements standa's notes (1)