Merge pull request #81 from lemeurherve/distinct-readme

fix(docs): proper (distinct) README for plugins.jenkins.io

README.md

@@ -4,6 +4,13 @@
 [![GitHub release](https://img.shields.io/github/release/jenkinsci/kubernetes-credentials-provider-plugin.svg?label=release)](https://github.com/jenkinsci/kubernetes-credentials-provider-plugin/releases/latest)
 [![Jenkins Plugin Installs](https://img.shields.io/jenkins/plugin/i/kubernetes-credentials-provider.svg?color=blue)](https://plugins.jenkins.io/kubernetes-credentials-provider)
 
-Jenkins credentials provider for Kubernetes
 
-Documentation is [here](https://jenkinsci.github.io/kubernetes-credentials-provider-plugin/)
+The *Kubernetes Credentials Provider* is a [Jenkins](https://jenkins.io) plugin to enable the retrieval of [Credentials](https://plugins.jenkins.io/credentials) stored as [Kubernetes Secrets](https://kubernetes.io/docs/concepts/configuration/secret/).
+
+The plugin supports most common credential types and defines an [`extension point`](https://jenkins.io/doc/developer/extensions/kubernetes-credentials-provider/) that can be implemented by other plugins to add support for custom Credential types. 
+
+The full documentation is available on [this GitHub page](https://jenkinsci.github.io/kubernetes-credentials-provider-plugin/).
+
+## Releases and Changelogs
+
+The [release notes](https://github.com/jenkinsci/kubernetes-credentials-provider-plugin/releases) are managed in GitHub. 

docs/README.md

@@ -4,7 +4,7 @@ title:  "Kubernetes Credentials Provider Plugin"
 permalink: /
 ---
 
-The *Kubernetes Credentials Provider* is a [Jenkins](https://jenkins.io) plugin to enable the retreival of [Credentials](https://plugins.jenkins.io/credentials) directly from Kubernetes.
+The *Kubernetes Credentials Provider* is a [Jenkins](https://jenkins.io) plugin to enable the retrieval of [Credentials](https://plugins.jenkins.io/credentials) stored as [Kubernetes Secrets](https://kubernetes.io/docs/concepts/configuration/secret/).
 
 The plugin supports most common credential types and defines an [`extension point`](https://jenkins.io/doc/developer/extensions/kubernetes-credentials-provider/) that can be implemented by other plugins to add support for custom Credential types.