{"action":"created","issue":{"url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/494","labels_url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/494/labels{/name}","comments_url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/494/comments","events_url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/494/events","html_url":"https://github.com/symfony-cmf/symfony-cmf-docs/issues/494","id":33421736,"number":494,"title":"How to document enabling","user":{"login":"WouterJ","id":749025,"avatar_url":"https://avatars.githubusercontent.com/u/749025?v=3","gravatar_id":"","url":"https://api.github.com/users/WouterJ","html_url":"https://github.com/WouterJ","followers_url":"https://api.github.com/users/WouterJ/followers","following_url":"https://api.github.com/users/WouterJ/following{/other_user}","gists_url":"https://api.github.com/users/WouterJ/gists{/gist_id}","starred_url":"https://api.github.com/users/WouterJ/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/WouterJ/subscriptions","organizations_url":"https://api.github.com/users/WouterJ/orgs","repos_url":"https://api.github.com/users/WouterJ/repos","events_url":"https://api.github.com/users/WouterJ/events{/privacy}","received_events_url":"https://api.github.com/users/WouterJ/received_events","type":"User","site_admin":false},"labels":[],"state":"open","locked":false,"assignee":null,"milestone":null,"comments":3,"created_at":"2014-05-13T17:45:52Z","updated_at":"2015-07-24T11:53:31Z","closed_at":null,"body":"Enabling a persistence layer can be done in various ways. Let's decided on how we do it:\r\n\r\nExplicit\r\n---\r\n````yaml\r\nphpcr:\r\n    enabled: true\r\n````\r\n````xml\r\n<phpcr enabled=\"true\" />\r\n````\r\n\r\nUsing `true`\r\n---\r\n````yaml\r\nphpcr: true\r\n````\r\n````xml\r\n<phpcr />\r\n````\r\n\r\nUsing `null`\r\n---\r\n````yaml\r\nphpcr: ~\r\n````\r\n````xml\r\n<phpcr />\r\n````\r\n\r\nI'm kind of in favor of using `true`, since it's very simple. But it looks very magic when we do things like this when configuring a manager:\r\n````yaml\r\nphpcr:\r\n    manager_name: default\r\n````\r\n````xml\r\n<phpcr manager-name=\"default\" />\r\n````\r\n\r\nOn the other hand, I thought we also did it in the core docs in one location and I've never heard people asking questions about it."},"comment":{"url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/comments/124498254","html_url":"https://github.com/symfony-cmf/symfony-cmf-docs/issues/494#issuecomment-124498254","issue_url":"https://api.github.com/repos/symfony-cmf/symfony-cmf-docs/issues/494","id":124498254,"user":{"login":"dbu","id":76576,"avatar_url":"https://avatars.githubusercontent.com/u/76576?v=3","gravatar_id":"","url":"https://api.github.com/users/dbu","html_url":"https://github.com/dbu","followers_url":"https://api.github.com/users/dbu/followers","following_url":"https://api.github.com/users/dbu/following{/other_user}","gists_url":"https://api.github.com/users/dbu/gists{/gist_id}","starred_url":"https://api.github.com/users/dbu/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/dbu/subscriptions","organizations_url":"https://api.github.com/users/dbu/orgs","repos_url":"https://api.github.com/users/dbu/repos","events_url":"https://api.github.com/users/dbu/events{/privacy}","received_events_url":"https://api.github.com/users/dbu/received_events","type":"User","site_admin":false},"created_at":"2015-07-24T11:53:31Z","updated_at":"2015-07-24T11:53:31Z","body":"we use canBeEnabled / canBeDisabled in most places, and the enabled attribute with true|false|auto in other places. do we need to do anything more about this in the doc?"}}