new iteration meschnism + some documentation