some documentation on the produced markup