additions and rearrange doc
fixed malformed table in doc