general iteration improving the documentation