spec for failing connection
update rockspec, add new documentation
write readme and reference manual