[docs] better comments in config files