fixed and expanded documentation