merge, plus legends reference documentation and updates to contributing.md