updated markup descriptions of the code