docs, change indices by making them less optional