adding usage, table of contents and documenting alternatives