Developer documentation

* PR: [when the PR is created, put a link to it here.  DO NOT use the "linked PR" feature]

---

Documentation to go alongside the code documentation and examples to show how to use edges.


