more docs, index complete. intro updated.