Improve YARD docstrings

- Add an extinsive explanation to Hexp::Node
- Bring the documentation of Hexp::Node#rewrite up to date
- Fix links and YARD warnings