better naming, added docs for linking resources