documentation, new functionality: candidate based config