documenting proxy usage