documentation + michal's work