more documentation improvements in models module