logic updates, markdown update