added doc and example script, fixed giveaways links