updated docs for supplied reservoirs