Add scope requirements and curl example for Star a repository.

Hi guys,
this patch adds scope requirements and curl example for the Star a repository action.

I had to first figure out which scope was needed by my application, then had to define
`Content-length: 0` header when sending the PUT request - otherwise it didn't work. So decided to document that.