put docs in subfolders
update docs readme
add how-to for reading docs
put validators in right folder
document Association and AssociationCurator