new key spec
improving key spec
new permission's spec
adding more examples
new repository's spec