improve errors
add markdown (kram) for descriptions