diff --git a/README.md b/README.md
index 07858a0..2a0dedb 100644
--- a/README.md
+++ b/README.md
@@ -6,4 +6,6 @@
 
 # Package vaultk8s
 
-Replaces: github.com/postfinance/vault/k8s
\ No newline at end of file
+Package vaultk8s provides authentication with Vault on Kubernetes
+
+Replaces: `github.com/postfinance/vault/k8s`
\ No newline at end of file
diff --git a/k8s.go b/k8s.go
index 56b4d44..e66b219 100644
--- a/k8s.go
+++ b/k8s.go
@@ -1,4 +1,4 @@
-// Package k8s provides authentication with Vault on Kubernetes
+// Package vaultk8s provides authentication with Vault on Kubernetes
 //
 // Authentication is done with the Kubernetes Auth Method by Vault.
 //