added example for Apache HttpClient and did initial investigation into using a transparent proxy
finished first draft of documentation and final tweaks resulting from updating documentation