First pass at docs for issue #306
updating http docs and copying to ruby and python