hopefully better docs + linkage