initial rewriting of the reference doc. Separated challenge api doc into another file and marked as obsolete.