Update api-stashes.md
added some info about stashes expiration and an example in the stashes API
[dec2] improved the overview page, removing inaccuracies that were causing confusion
Merge pull request #60 from jaimegago/patch-1

stashes-expiration details
Merge pull request #63 from portertech/dec2

Improved the overview page, removing inaccuracies