@dschult I incorporated (nearly verbatim) your suggestions...  I tested and then remembered an important aspect of d(s,t) - which is testing for all combinations of paths between 's' and 't' in ST.  Any thoughts on how to optimize here?

@bjedwards I will incorporate your original suggestions re: documentation - is there anything else you'd like to see?