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