fleshing out pubsub docs, fixing link issues, etc