diff --git a/include/git2/common.h b/include/git2/common.h
index 400f2f611..8566b290e 100644
--- a/include/git2/common.h
+++ b/include/git2/common.h
@@ -341,6 +341,10 @@ typedef enum {
  *  * opts(GIT_OPT_ADD_SSL_X509_CERT, const X509 *cert)
  *     
  *      > Add a raw X509 certificate into the SSL certs store.
+ *      > The added certificate is not persisted and will be used
+ *      > only during application lifetime. Also there is no ability
+ *      > to remove a certificate from the store during app lifetime
+ *      > after it was added. 
  * 		> 
  * 		> - `cert` is the raw X509 cert will be added to cert store.
  *