documentation around connections and contexts