#48: just enhanced documentation
Finishes #48. For now ...