add markdown docs that were supposed to have been added in the last merge