took first pass at adding documentation to index.md