fixes most of the toctree warnings in #21

brings the warning count from down from
8210 to 114