split discussion into separate doc and make front page more suitable for first intro

also remove some stuff from manpages that is now in discussion