more documentation - yet incomplete