some documenting. small fixes