docs updated : check readme and curved boreholes, as well as improvements to refs