add sample squid file
fleshing out documentation in excruciating detail.