Use indices for links

This makes them work locally with YARD.
Overhaul documentation