{"action":"created","issue":{"url":"https://api.github.com/repos/openSUSE/daps/issues/347","repository_url":"https://api.github.com/repos/openSUSE/daps","labels_url":"https://api.github.com/repos/openSUSE/daps/issues/347/labels{/name}","comments_url":"https://api.github.com/repos/openSUSE/daps/issues/347/comments","events_url":"https://api.github.com/repos/openSUSE/daps/issues/347/events","html_url":"https://github.com/openSUSE/daps/issues/347","id":136701700,"node_id":"MDU6SXNzdWUxMzY3MDE3MDA=","number":347,"title":"Make Product Names and Titles \"Shareable\"","user":{"login":"tomschr","id":1312925,"node_id":"MDQ6VXNlcjEzMTI5MjU=","avatar_url":"https://avatars2.githubusercontent.com/u/1312925?v=4","gravatar_id":"","url":"https://api.github.com/users/tomschr","html_url":"https://github.com/tomschr","followers_url":"https://api.github.com/users/tomschr/followers","following_url":"https://api.github.com/users/tomschr/following{/other_user}","gists_url":"https://api.github.com/users/tomschr/gists{/gist_id}","starred_url":"https://api.github.com/users/tomschr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomschr/subscriptions","organizations_url":"https://api.github.com/users/tomschr/orgs","repos_url":"https://api.github.com/users/tomschr/repos","events_url":"https://api.github.com/users/tomschr/events{/privacy}","received_events_url":"https://api.github.com/users/tomschr/received_events","type":"User","site_admin":false},"labels":[{"id":182705014,"node_id":"MDU6TGFiZWwxODI3MDUwMTQ=","url":"https://api.github.com/repos/openSUSE/daps/labels/enhancement","name":"enhancement","color":"84b6eb","default":true},{"id":182705015,"node_id":"MDU6TGFiZWwxODI3MDUwMTU=","url":"https://api.github.com/repos/openSUSE/daps/labels/help%20wanted","name":"help wanted","color":"159818","default":true},{"id":182801702,"node_id":"MDU6TGFiZWwxODI4MDE3MDI=","url":"https://api.github.com/repos/openSUSE/daps/labels/idea","name":"idea","color":"fef2c0","default":false},{"id":182860431,"node_id":"MDU6TGFiZWwxODI4NjA0MzE=","url":"https://api.github.com/repos/openSUSE/daps/labels/infrastructure","name":"infrastructure","color":"ededed","default":false},{"id":182705017,"node_id":"MDU6TGFiZWwxODI3MDUwMTc=","url":"https://api.github.com/repos/openSUSE/daps/labels/question","name":"question","color":"cc317c","default":true},{"id":182751261,"node_id":"MDU6TGFiZWwxODI3NTEyNjE=","url":"https://api.github.com/repos/openSUSE/daps/labels/validation","name":"validation","color":"ededed","default":false}],"state":"closed","locked":false,"assignee":{"login":"tomschr","id":1312925,"node_id":"MDQ6VXNlcjEzMTI5MjU=","avatar_url":"https://avatars2.githubusercontent.com/u/1312925?v=4","gravatar_id":"","url":"https://api.github.com/users/tomschr","html_url":"https://github.com/tomschr","followers_url":"https://api.github.com/users/tomschr/followers","following_url":"https://api.github.com/users/tomschr/following{/other_user}","gists_url":"https://api.github.com/users/tomschr/gists{/gist_id}","starred_url":"https://api.github.com/users/tomschr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomschr/subscriptions","organizations_url":"https://api.github.com/users/tomschr/orgs","repos_url":"https://api.github.com/users/tomschr/repos","events_url":"https://api.github.com/users/tomschr/events{/privacy}","received_events_url":"https://api.github.com/users/tomschr/received_events","type":"User","site_admin":false},"assignees":[{"login":"tomschr","id":1312925,"node_id":"MDQ6VXNlcjEzMTI5MjU=","avatar_url":"https://avatars2.githubusercontent.com/u/1312925?v=4","gravatar_id":"","url":"https://api.github.com/users/tomschr","html_url":"https://github.com/tomschr","followers_url":"https://api.github.com/users/tomschr/followers","following_url":"https://api.github.com/users/tomschr/following{/other_user}","gists_url":"https://api.github.com/users/tomschr/gists{/gist_id}","starred_url":"https://api.github.com/users/tomschr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/tomschr/subscriptions","organizations_url":"https://api.github.com/users/tomschr/orgs","repos_url":"https://api.github.com/users/tomschr/repos","events_url":"https://api.github.com/users/tomschr/events{/privacy}","received_events_url":"https://api.github.com/users/tomschr/received_events","type":"User","site_admin":false}],"milestone":null,"comments":1,"created_at":"2016-02-26T13:45:45Z","updated_at":"2018-10-23T17:09:42Z","closed_at":"2018-10-23T17:09:42Z","author_association":"COLLABORATOR","body":"(Original idea from Tanja)\r\n### Problem\r\n\r\nCurrently, all our doc repos contain an `entity-decl.ent` file. This file contains lots of product names and titles. When product names or titles change, all files should be updated (in theory).\r\n\r\nAt the moment we don't have a file which can be shared across different products and repos.\r\n### Properties\r\n\r\nIt is assumed that the product parts change only, when\r\n- a new product is requested, or\r\n- an existing product changes its product name, title, or both (very rarely)\r\n\r\nThe  `entity-decl.ent` file needs to be splitted into a part with and without the product parts. The product part should contain only text (no elements to avoid any DocBook 4 vs. 5 problems) and no version number (this should go into the corresponding XML file).\r\n### Possible Solutions\r\n1. Using an URI in  `entity-decl.ent`, referring to the product specific parts:\r\n   \r\n   ``` xml\r\n   <!-- file: entity-decl.ent -->\r\n   <!ENTITY % products SYSTEM \"http://www.example.org/common/products-decl.ent\">\r\n   % products;\r\n   ```\r\n2. Using [Git Submodules](http://www.git-scm.com/book/en/v2/Git-Tools-Submodules)\r\n3. Use DAPS \"Branding\" project for the common content, as is done in Publican's \"Brands\" concept  (this would necessitate getting our Hack Week concept for DAPS shippable).\r\n4. Something else?\r\n### Discussion\r\n1. Using an URI in the `entity-decl.ent`\r\n   \r\n   **Pros**: `products-decl.ent` will be downloaded when it's needed. It's always up-to-date.\r\n   **Cons**: You can't build the product without Internet connection\r\n2. Using Git Submodules\r\n   \r\n   **Pros**: Just another Git repo; doesn't need to be updated often, but could be (maybe?) done via Git hooks\r\n   **Cons**: You need to actively update the submodule dir (maybe Git hooks come to the rescue?)\r\n\r\n3. \"Brands\"\r\n   **Pros**: One central location, always included\r\n   **Cons**: Needs new DAPS functionality that includes the brand; If \"brands\" are RPMs like on Fedora, updating them will take pretty long (especially in OBS) and not everybody may be using the same version (i.e. there are content changes that depend on the version of a particular RPM) \r\n\r\n@taroth21, @sknorr: Anything to add from your side?\r\n\r\n---\r\n\r\n[**edit by sknorr** Under \"Possible Solutions\", added idea of using \"brands\".]\r\n"},"comment":{"url":"https://api.github.com/repos/openSUSE/daps/issues/comments/432335768","html_url":"https://github.com/openSUSE/daps/issues/347#issuecomment-432335768","issue_url":"https://api.github.com/repos/openSUSE/daps/issues/347","id":432335768,"node_id":"MDEyOklzc3VlQ29tbWVudDQzMjMzNTc2OA==","user":{"login":"sknorr","id":5476547,"node_id":"MDQ6VXNlcjU0NzY1NDc=","avatar_url":"https://avatars0.githubusercontent.com/u/5476547?v=4","gravatar_id":"","url":"https://api.github.com/users/sknorr","html_url":"https://github.com/sknorr","followers_url":"https://api.github.com/users/sknorr/followers","following_url":"https://api.github.com/users/sknorr/following{/other_user}","gists_url":"https://api.github.com/users/sknorr/gists{/gist_id}","starred_url":"https://api.github.com/users/sknorr/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sknorr/subscriptions","organizations_url":"https://api.github.com/users/sknorr/orgs","repos_url":"https://api.github.com/users/sknorr/repos","events_url":"https://api.github.com/users/sknorr/events{/privacy}","received_events_url":"https://api.github.com/users/sknorr/received_events","type":"User","site_admin":false},"created_at":"2018-10-23T17:09:42Z","updated_at":"2018-10-23T17:09:42Z","author_association":"MEMBER","body":"-> https://github.com/openSUSE/doc-kit"}}
{"actor":{"display_login":"sknorr"}}