before we start with this - I'm wondering whether there's a better place than code repository for this - redmine wiki? foreman manual? anyway I'll have to update this a bit so I'd like to do it at correct place