added documentation about sorting