changed docs from parameters.ini to .yaml, improved formatting