improvement and docs for variety black box creation