tweaked documentation and internal details