improved source documentation