Merge pull request #1780 from laurentbristiel/master

change template/README.txt to .rst + use bullet points in the file
explicit the fact that when key exists then update is performed