[jira] [Commented] (GEODE-8829) Improve copy-on-read docs

["ASF GitHub Bot (Jira)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/GEODE-8829?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=17266190#comment-17266190 ] 

ASF GitHub Bot commented on GEODE-8829:
---------------------------------------

karensmolermiller opened a new pull request #5908:
URL: https://github.com/apache/geode/pull/5908


   I spoke with @boglesby about documenting how to set copy-on-read via the API. We decided that it would be best not to document it.  There's no correct/good way to do it for a production-grade cluster, and the API appears to exist so that a gfsh alter command can use it to set copy-on-read in a way that gets propagated to the cluster's configuration.
   


----------------------------------------------------------------
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:
users@infra.apache.org


> Improve copy-on-read docs
> -------------------------
>
>                 Key: GEODE-8829
>                 URL: https://issues.apache.org/jira/browse/GEODE-8829
>             Project: Geode
>          Issue Type: Improvement
>          Components: docs
>            Reporter: Karen Smoler Miller
>            Assignee: Karen Smoler Miller
>            Priority: Major
>
> The section describing copy-on-read is incomplete. Add two other ways to set copy-on-read to true:
> 1. Use the API GemFireCache.setCopyOnRead() method; Cache inherits this method, so an example would show Cache.setCopyOnRead() in use.
> 2. The gfsh alter runtime has an option to set copy-on-read to true. Use this once servers are running.
> At the same time, update the example that demonstrates making a copy. Add prose to the current example to explain why the put call belongs in this example.  Or, revise the example to show only the making of the copy.



--
This message was sent by Atlassian Jira
(v8.3.4#803005)