removed global variables from documentation, converted to markdown