davebarnes97 commented on pull request #6367:
URL: https://github.com/apache/geode/pull/6367#issuecomment-830204665


   Thanks for requesting a docs review, @jhutchison.
   
   I would recommend against describing this feature as a "new addition."
   What we're calling out here is that the      API might change. "Newness" as 
an explanation   will soon become stale,
   but "Experimental" will      hold true over time.
   
   Suggested re-wordings -- you may recognize the language from your 
contributions to the user guide:
   
   In the several identical cases that begin with the tag "Experimental:", I 
suggest changing
   
   "Experimental: Geode API compatible with Redis is a new addition to Geode 
and the API may change"
   
   to
   
   "Experimental: Geode API compatible with Redis is subject to change in 
future releases"
   
   For the case in japicmp_exceptions.json, where the word "experimental" is 
not used, I would introduce it, replacing
   
   "Geode API compatible with Redis is a new addition to Geode and the API may 
change"
   
   with
   
   "Geode API compatible with Redis is experimental and is subject to change in 
future releases"
   


-- 
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.

For queries about this service, please contact Infrastructure at:
[email protected]


Reply via email to