documentation
document problems with default values