[pjbrow]

Agree that foot / end noting is another good way to do it - the important thing is the drafting technique rather than the way it's implemented.

We're using Github permalinks to cover the linking issue for now, but we're discussing more permanent options. Would be interested to hear what other ways people think would work.

There's also the option for users to download the repos and use the commit hash in the document proper for reference.