helper gotchas

refs #3671
add docs/README as a docs index page
fix readme typo
update readme documentation links
fix docs/readme links
refactor TargetNotFound Error
rename and improve custom index docs
list all index pages in docs readme