{"action":"created","issue":{"url":"https://api.github.com/repos/magento/devdocs/issues/776","repository_url":"https://api.github.com/repos/magento/devdocs","labels_url":"https://api.github.com/repos/magento/devdocs/issues/776/labels{/name}","comments_url":"https://api.github.com/repos/magento/devdocs/issues/776/comments","events_url":"https://api.github.com/repos/magento/devdocs/issues/776/events","html_url":"https://github.com/magento/devdocs/issues/776","id":168465618,"number":776,"title":"Questions on private page content documentation","user":{"login":"Vinai","id":72463,"avatar_url":"https://avatars.githubusercontent.com/u/72463?v=3","gravatar_id":"","url":"https://api.github.com/users/Vinai","html_url":"https://github.com/Vinai","followers_url":"https://api.github.com/users/Vinai/followers","following_url":"https://api.github.com/users/Vinai/following{/other_user}","gists_url":"https://api.github.com/users/Vinai/gists{/gist_id}","starred_url":"https://api.github.com/users/Vinai/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/Vinai/subscriptions","organizations_url":"https://api.github.com/users/Vinai/orgs","repos_url":"https://api.github.com/users/Vinai/repos","events_url":"https://api.github.com/users/Vinai/events{/privacy}","received_events_url":"https://api.github.com/users/Vinai/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":{"login":"xcomSteveJohnson","id":1268334,"avatar_url":"https://avatars.githubusercontent.com/u/1268334?v=3","gravatar_id":"","url":"https://api.github.com/users/xcomSteveJohnson","html_url":"https://github.com/xcomSteveJohnson","followers_url":"https://api.github.com/users/xcomSteveJohnson/followers","following_url":"https://api.github.com/users/xcomSteveJohnson/following{/other_user}","gists_url":"https://api.github.com/users/xcomSteveJohnson/gists{/gist_id}","starred_url":"https://api.github.com/users/xcomSteveJohnson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xcomSteveJohnson/subscriptions","organizations_url":"https://api.github.com/users/xcomSteveJohnson/orgs","repos_url":"https://api.github.com/users/xcomSteveJohnson/repos","events_url":"https://api.github.com/users/xcomSteveJohnson/events{/privacy}","received_events_url":"https://api.github.com/users/xcomSteveJohnson/received_events","type":"User","site_admin":false},"assignees":[{"login":"xcomSteveJohnson","id":1268334,"avatar_url":"https://avatars.githubusercontent.com/u/1268334?v=3","gravatar_id":"","url":"https://api.github.com/users/xcomSteveJohnson","html_url":"https://github.com/xcomSteveJohnson","followers_url":"https://api.github.com/users/xcomSteveJohnson/followers","following_url":"https://api.github.com/users/xcomSteveJohnson/following{/other_user}","gists_url":"https://api.github.com/users/xcomSteveJohnson/gists{/gist_id}","starred_url":"https://api.github.com/users/xcomSteveJohnson/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/xcomSteveJohnson/subscriptions","organizations_url":"https://api.github.com/users/xcomSteveJohnson/orgs","repos_url":"https://api.github.com/users/xcomSteveJohnson/repos","events_url":"https://api.github.com/users/xcomSteveJohnson/events{/privacy}","received_events_url":"https://api.github.com/users/xcomSteveJohnson/received_events","type":"User","site_admin":false}],"milestone":null,"comments":7,"created_at":"2016-07-30T12:39:33Z","updated_at":"2016-08-15T15:15:38Z","closed_at":null,"body":"Hi,\r\nreading the page http://devdocs.magento.com/guides/v2.1/config-guide/cache/cache-priv-priv.html and trying to follow along by creating my own example private content block, I don't find answers to the following questions.  \r\nIt would be great if the documentation could be improved by the original author to include more information to make it simpler to follow.\r\n\r\n-----\r\n\r\nWhy is there no example for \"Replace private data in blocks with placeholders (using Knockout syntax).\"? A link to some core code where that is done would be helpful.\r\n\r\n-----\r\n\r\nDoes the `data-bind=\"scope: 'compareProducts'\"` JS identifier correspond to the item name in the `sectionSourceMap` di configuration, just in CamelCase? It seems like it does, but the documentation doesn't say so, and there is so much complex mapping going on it would be good to state such things explicitly instead of relying on the reader to make the correct assumptions.\r\n\r\n-----\r\n\r\nWhy does the private content JS have to be initialized with such boilerplate code?\r\n\r\n```\r\n<script type=\"text/x-magento-init\">\r\n    {\"<css-selector>\": {\"Magento_Ui/js/core/app\": <?php echo getJsLayout();?>}}\r\n</script>\r\n```\r\n\r\nIt seems the only thing that can be changed is the css selector. Can the selector be freely chosen or does it have to correspond to the section name in some way? Does it have to specify a single DOM element or can it match multiple elements?  \r\nIs it possible to use the `data-mage-init` initialization, too? If so, an example would help to clarify.\r\n\r\n-----\r\n\r\nIn the linked UI component JS example, the selector `[data-role=compare-products-sidebar]` is also specified as part of the [JS initialization example](https://github.com/magento/magento2/blob/2.0/app/code/Magento/Catalog/view/frontend/templates/product/compare/sidebar.phtml#L46-L48), so the element should be passed to the component initialization function in JS.  \r\nAccording to best practices, the view models should be decoupled from the DOM. That is is not used here is confusing and it would be good if the documentation would give a reason for it.\r\n\r\n-----\r\n\r\nIs `$_isScopePrivate` really deprecated? It isn't marked as such in the source code:\r\n(see https://github.com/magento/magento2/blob/develop/lib/internal/Magento/Framework/View/Element/AbstractBlock.php#L163 and https://github.com/magento/magento2/blob/develop/lib/internal/Magento/Framework/View/Element/AbstractBlock.php#L1108).\r\n\r\nAccording to the documentation \"This property is obsolete and won't work properly.\".  \r\nIf so, why is it still present in the core code and not marked as `@deprecated`?  \r\nA quick test shows it seems to be working correctly. Under what circumstances does it not work?\r\n\r\n-----\r\n\r\nWhat if I want to render the private content server side and not in knockout?  \r\nThe obsolete `isScopePrivate()` method made that very easy and convenient.\r\nThe \"new\" ui component approach seems overly complicated in comparison.  \r\nFor example, if I just want to render a simple string as private content, this seems like too much work. Is there a simpler (supported) way to display private scope content?\r\n\r\n-----\r\n\r\nOn that note, is it possible to display private content without having to define a UI component?  \r\nIf so it would be great to add it to the documentation, as it would be a wonderful thing!\r\n\r\n-----\r\n\r\nOn \"defining a UI component in a layout\" only an example is linked, but what is that content? What is required? What can be customized? Does it have to be a `jsLayout` layout argument, or can it be anything?\r\n\r\n\r\n"},"comment":{"url":"https://api.github.com/repos/magento/devdocs/issues/comments/239829337","html_url":"https://github.com/magento/devdocs/issues/776#issuecomment-239829337","issue_url":"https://api.github.com/repos/magento/devdocs/issues/776","id":239829337,"user":{"login":"tanberry","id":9368837,"avatar_url":"https://avatars.githubusercontent.com/u/9368837?v=3","gravatar_id":"","url":"https://api.github.com/users/tanberry","html_url":"https://github.com/tanberry","followers_url":"https://api.github.com/users/tanberry/followers","following_url":"https://api.github.com/users/tanberry/following{/other_user}","gists_url":"https://api.github.com/users/tanberry/gists{/gist_id}","starred_url":"https://api.github.com/users/tanberry/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tanberry/subscriptions","organizations_url":"https://api.github.com/users/tanberry/orgs","repos_url":"https://api.github.com/users/tanberry/repos","events_url":"https://api.github.com/users/tanberry/events{/privacy}","received_events_url":"https://api.github.com/users/tanberry/received_events","type":"User","site_admin":false},"created_at":"2016-08-15T15:15:37Z","updated_at":"2016-08-15T15:15:37Z","body":"@Vinai and @ryantfowler , we just completed our first day of the Doc Sprint for UI components, here in the Kyiv office! Our most important step was to create the outline with the core developers, and then prioritize the topics. (We also went over our plan for how the Doc Sprint would work, agreed on demos for each new topic, process for the core developers to contribute to devdocs repo, etc). We would now like to ask for feedback on the outline: i.e. have we identified the most important topics, prioritized them correctly, etc.\r\nCan you email me at tanberry@magento.com, please?"}}
{"actor":{"display_login":"tanberry"}}