Fix up syntax, grammar, missing links and typos
update directions on how to update these docs