added indexes and transformer sections, marked articles with TODO
documented indexes/querying/paging