Add notes to don't use the map opacity slider in the XAPI

And other changes especially in the api config.

fix: https://github.com/camptocamp/cgxp/issues/466