add clarifications and ease of reading