{"action":"created","comment":{"url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/comments/182681804","pull_request_review_id":113523460,"id":182681804,"diff_hunk":"@@ -0,0 +1,555 @@\n+.. _changes:\n+\n+Changes/Hints for migration\n+===========================\n+\n+This section will give you hints how to handle version migration. Since the project moves forward it will\n+introduce differences in the yml configuration file. So it would not be enough to simply install newest\n+version. Often a version upgrade changes or add parameters which are used.\n+\n+.. _changes-version-1.1.0:\n+\n+Version 1.1.0\n+-------------\n+\n+The stable version 1.1.0 contains a lot of changes. It can be counted as the first version to be used in\n+production mode. When you are updating from previous version to 1.1.0 you will have to adjust your yml file.\n+Description below will try to classify new options whether they are *optional* or **mandatory** to use the\n+new version.\n+Of course you also could use the way described in the ``installation-step-configuration``. But then it will\n+create a completely new yml but valid file. In order to that its up to your decision: Migrate new options to\n+your existing configuration or migrate your custom configuration into a newly created file.\n+\n+Here is a list of features this version additionally implements compared to\n+`1.0.1 <https://github.com/camptocamp/pyramid_oereb/releases/tag/v1.0.1>`__:\n+\n+.. _changes-oereb-lex:\n+\n+OEREBlex\n+^^^^^^^^\n+\n+This version includes binding/adapter to oereb lex. The code can be found\n+`here <https://github.com/camptocamp/pyramid_oereb/blob/v1.1.0/pyramid_oereb/contrib/sources/plr_oereblex.py>`__.\n+This should enable you to use OEREBlex with a minimum of configuration.\n+See :ref:`changes-new-config-oereb-lex` for further details of configuration options.\n+\n+The idea of this oereb lex adapter is to access OEREBlex documents directly via API provided by OEREBlex.\n+This you can configure this per theme. If you have a theme which has all documents stored in OEREBlex you\n+will need a link to the dedicated set of documents for every public law restriction in this theme. You will\n+end up with an attribute in the database table for your public law restriction which contains the link.\n+\n+.. note:: OREBlex uses unique ids for the document sets. To prevent from storing redundant data and for\n+    simplifying things we decided to not store the complete link in database attribute but the id only!\n+\n+Regarding to the note above we assume you have stored the correct id of your OEREBlex document set per public\n+law restriction in your database table.\n+\n+The next step is to define the sqlalchemy mappings. This works like normal mapping definition described here:\n+:ref:`configuration-adapt-models`. The difference to the standard database configuration is here:\n+\n+- all document related model classes are obsolete","path":"doc/source/changes.rst","position":50,"original_position":50,"commit_id":"4e2813b99795d02b1a5476d0bff8ef3528d49fc0","original_commit_id":"4e2813b99795d02b1a5476d0bff8ef3528d49fc0","user":{"login":"ger-benjamin","id":1792111,"avatar_url":"https://avatars1.githubusercontent.com/u/1792111?v=4","gravatar_id":"","url":"https://api.github.com/users/ger-benjamin","html_url":"https://github.com/ger-benjamin","followers_url":"https://api.github.com/users/ger-benjamin/followers","following_url":"https://api.github.com/users/ger-benjamin/following{/other_user}","gists_url":"https://api.github.com/users/ger-benjamin/gists{/gist_id}","starred_url":"https://api.github.com/users/ger-benjamin/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ger-benjamin/subscriptions","organizations_url":"https://api.github.com/users/ger-benjamin/orgs","repos_url":"https://api.github.com/users/ger-benjamin/repos","events_url":"https://api.github.com/users/ger-benjamin/events{/privacy}","received_events_url":"https://api.github.com/users/ger-benjamin/received_events","type":"User","site_admin":false},"body":"Missing final dot.\r\nThen missing major letter to start both lines under","created_at":"2018-04-19T09:13:21Z","updated_at":"2018-04-19T09:34:53Z","html_url":"https://github.com/camptocamp/pyramid_oereb/pull/502#discussion_r182681804","pull_request_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/comments/182681804"},"html":{"href":"https://github.com/camptocamp/pyramid_oereb/pull/502#discussion_r182681804"},"pull_request":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502"}}},"pull_request":{"url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502","id":181517403,"html_url":"https://github.com/camptocamp/pyramid_oereb/pull/502","diff_url":"https://github.com/camptocamp/pyramid_oereb/pull/502.diff","patch_url":"https://github.com/camptocamp/pyramid_oereb/pull/502.patch","issue_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/502","number":502,"state":"open","locked":false,"title":"[WIP] Improve documentation","user":{"login":"vvmruder","id":3714179,"avatar_url":"https://avatars3.githubusercontent.com/u/3714179?v=4","gravatar_id":"","url":"https://api.github.com/users/vvmruder","html_url":"https://github.com/vvmruder","followers_url":"https://api.github.com/users/vvmruder/followers","following_url":"https://api.github.com/users/vvmruder/following{/other_user}","gists_url":"https://api.github.com/users/vvmruder/gists{/gist_id}","starred_url":"https://api.github.com/users/vvmruder/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/vvmruder/subscriptions","organizations_url":"https://api.github.com/users/vvmruder/orgs","repos_url":"https://api.github.com/users/vvmruder/repos","events_url":"https://api.github.com/users/vvmruder/events{/privacy}","received_events_url":"https://api.github.com/users/vvmruder/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-04-13T15:12:18Z","updated_at":"2018-04-19T09:34:54Z","closed_at":null,"merged_at":null,"merge_commit_sha":"5d9ff4e4d4fe034d331650ae8a00d3c92f02789f","assignee":null,"assignees":[],"requested_reviewers":[{"login":"sbrunner","id":353872,"avatar_url":"https://avatars3.githubusercontent.com/u/353872?v=4","gravatar_id":"","url":"https://api.github.com/users/sbrunner","html_url":"https://github.com/sbrunner","followers_url":"https://api.github.com/users/sbrunner/followers","following_url":"https://api.github.com/users/sbrunner/following{/other_user}","gists_url":"https://api.github.com/users/sbrunner/gists{/gist_id}","starred_url":"https://api.github.com/users/sbrunner/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sbrunner/subscriptions","organizations_url":"https://api.github.com/users/sbrunner/orgs","repos_url":"https://api.github.com/users/sbrunner/repos","events_url":"https://api.github.com/users/sbrunner/events{/privacy}","received_events_url":"https://api.github.com/users/sbrunner/received_events","type":"User","site_admin":false},{"login":"jwkaltz","id":9261252,"avatar_url":"https://avatars1.githubusercontent.com/u/9261252?v=4","gravatar_id":"","url":"https://api.github.com/users/jwkaltz","html_url":"https://github.com/jwkaltz","followers_url":"https://api.github.com/users/jwkaltz/followers","following_url":"https://api.github.com/users/jwkaltz/following{/other_user}","gists_url":"https://api.github.com/users/jwkaltz/gists{/gist_id}","starred_url":"https://api.github.com/users/jwkaltz/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jwkaltz/subscriptions","organizations_url":"https://api.github.com/users/jwkaltz/orgs","repos_url":"https://api.github.com/users/jwkaltz/repos","events_url":"https://api.github.com/users/jwkaltz/events{/privacy}","received_events_url":"https://api.github.com/users/jwkaltz/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502/commits","review_comments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502/comments","review_comment_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/comments{/number}","comments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/502/comments","statuses_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/statuses/4e2813b99795d02b1a5476d0bff8ef3528d49fc0","head":{"label":"camptocamp:improve_doc","ref":"improve_doc","sha":"4e2813b99795d02b1a5476d0bff8ef3528d49fc0","user":{"login":"camptocamp","id":28109,"avatar_url":"https://avatars0.githubusercontent.com/u/28109?v=4","gravatar_id":"","url":"https://api.github.com/users/camptocamp","html_url":"https://github.com/camptocamp","followers_url":"https://api.github.com/users/camptocamp/followers","following_url":"https://api.github.com/users/camptocamp/following{/other_user}","gists_url":"https://api.github.com/users/camptocamp/gists{/gist_id}","starred_url":"https://api.github.com/users/camptocamp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/camptocamp/subscriptions","organizations_url":"https://api.github.com/users/camptocamp/orgs","repos_url":"https://api.github.com/users/camptocamp/repos","events_url":"https://api.github.com/users/camptocamp/events{/privacy}","received_events_url":"https://api.github.com/users/camptocamp/received_events","type":"Organization","site_admin":false},"repo":{"id":80502017,"name":"pyramid_oereb","full_name":"camptocamp/pyramid_oereb","owner":{"login":"camptocamp","id":28109,"avatar_url":"https://avatars0.githubusercontent.com/u/28109?v=4","gravatar_id":"","url":"https://api.github.com/users/camptocamp","html_url":"https://github.com/camptocamp","followers_url":"https://api.github.com/users/camptocamp/followers","following_url":"https://api.github.com/users/camptocamp/following{/other_user}","gists_url":"https://api.github.com/users/camptocamp/gists{/gist_id}","starred_url":"https://api.github.com/users/camptocamp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/camptocamp/subscriptions","organizations_url":"https://api.github.com/users/camptocamp/orgs","repos_url":"https://api.github.com/users/camptocamp/repos","events_url":"https://api.github.com/users/camptocamp/events{/privacy}","received_events_url":"https://api.github.com/users/camptocamp/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/camptocamp/pyramid_oereb","description":null,"fork":false,"url":"https://api.github.com/repos/camptocamp/pyramid_oereb","forks_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/forks","keys_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/keys{/key_id}","collaborators_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/teams","hooks_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/hooks","issue_events_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/events{/number}","events_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/events","assignees_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/assignees{/user}","branches_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/branches{/branch}","tags_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/tags","blobs_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/refs{/sha}","trees_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/trees{/sha}","statuses_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/statuses/{sha}","languages_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/languages","stargazers_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/stargazers","contributors_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/contributors","subscribers_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/subscribers","subscription_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/subscription","commits_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/commits{/sha}","git_commits_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/commits{/sha}","comments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/comments{/number}","issue_comment_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/comments{/number}","contents_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/contents/{+path}","compare_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/compare/{base}...{head}","merges_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/merges","archive_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/downloads","issues_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues{/number}","pulls_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls{/number}","milestones_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/milestones{/number}","notifications_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/labels{/name}","releases_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/releases{/id}","deployments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/deployments","created_at":"2017-01-31T08:09:25Z","updated_at":"2018-04-10T12:30:59Z","pushed_at":"2018-04-18T14:40:35Z","git_url":"git://github.com/camptocamp/pyramid_oereb.git","ssh_url":"git@github.com:camptocamp/pyramid_oereb.git","clone_url":"https://github.com/camptocamp/pyramid_oereb.git","svn_url":"https://github.com/camptocamp/pyramid_oereb","homepage":null,"size":143250,"stargazers_count":2,"watchers_count":2,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":3,"mirror_url":null,"archived":false,"open_issues_count":25,"license":{"key":"other","name":"Other","spdx_id":null,"url":null},"forks":3,"open_issues":25,"watchers":2,"default_branch":"master"}},"base":{"label":"camptocamp:master","ref":"master","sha":"e5b71039f72cea558f5757fa3b39ce76179376f5","user":{"login":"camptocamp","id":28109,"avatar_url":"https://avatars0.githubusercontent.com/u/28109?v=4","gravatar_id":"","url":"https://api.github.com/users/camptocamp","html_url":"https://github.com/camptocamp","followers_url":"https://api.github.com/users/camptocamp/followers","following_url":"https://api.github.com/users/camptocamp/following{/other_user}","gists_url":"https://api.github.com/users/camptocamp/gists{/gist_id}","starred_url":"https://api.github.com/users/camptocamp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/camptocamp/subscriptions","organizations_url":"https://api.github.com/users/camptocamp/orgs","repos_url":"https://api.github.com/users/camptocamp/repos","events_url":"https://api.github.com/users/camptocamp/events{/privacy}","received_events_url":"https://api.github.com/users/camptocamp/received_events","type":"Organization","site_admin":false},"repo":{"id":80502017,"name":"pyramid_oereb","full_name":"camptocamp/pyramid_oereb","owner":{"login":"camptocamp","id":28109,"avatar_url":"https://avatars0.githubusercontent.com/u/28109?v=4","gravatar_id":"","url":"https://api.github.com/users/camptocamp","html_url":"https://github.com/camptocamp","followers_url":"https://api.github.com/users/camptocamp/followers","following_url":"https://api.github.com/users/camptocamp/following{/other_user}","gists_url":"https://api.github.com/users/camptocamp/gists{/gist_id}","starred_url":"https://api.github.com/users/camptocamp/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/camptocamp/subscriptions","organizations_url":"https://api.github.com/users/camptocamp/orgs","repos_url":"https://api.github.com/users/camptocamp/repos","events_url":"https://api.github.com/users/camptocamp/events{/privacy}","received_events_url":"https://api.github.com/users/camptocamp/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/camptocamp/pyramid_oereb","description":null,"fork":false,"url":"https://api.github.com/repos/camptocamp/pyramid_oereb","forks_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/forks","keys_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/keys{/key_id}","collaborators_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/teams","hooks_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/hooks","issue_events_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/events{/number}","events_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/events","assignees_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/assignees{/user}","branches_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/branches{/branch}","tags_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/tags","blobs_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/refs{/sha}","trees_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/trees{/sha}","statuses_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/statuses/{sha}","languages_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/languages","stargazers_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/stargazers","contributors_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/contributors","subscribers_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/subscribers","subscription_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/subscription","commits_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/commits{/sha}","git_commits_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/git/commits{/sha}","comments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/comments{/number}","issue_comment_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/comments{/number}","contents_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/contents/{+path}","compare_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/compare/{base}...{head}","merges_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/merges","archive_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/downloads","issues_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues{/number}","pulls_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls{/number}","milestones_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/milestones{/number}","notifications_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/labels{/name}","releases_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/releases{/id}","deployments_url":"https://api.github.com/repos/camptocamp/pyramid_oereb/deployments","created_at":"2017-01-31T08:09:25Z","updated_at":"2018-04-10T12:30:59Z","pushed_at":"2018-04-18T14:40:35Z","git_url":"git://github.com/camptocamp/pyramid_oereb.git","ssh_url":"git@github.com:camptocamp/pyramid_oereb.git","clone_url":"https://github.com/camptocamp/pyramid_oereb.git","svn_url":"https://github.com/camptocamp/pyramid_oereb","homepage":null,"size":143250,"stargazers_count":2,"watchers_count":2,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":true,"has_pages":true,"forks_count":3,"mirror_url":null,"archived":false,"open_issues_count":25,"license":{"key":"other","name":"Other","spdx_id":null,"url":null},"forks":3,"open_issues":25,"watchers":2,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502"},"html":{"href":"https://github.com/camptocamp/pyramid_oereb/pull/502"},"issue":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/502"},"comments":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/issues/502/comments"},"review_comments":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502/comments"},"review_comment":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/pulls/502/commits"},"statuses":{"href":"https://api.github.com/repos/camptocamp/pyramid_oereb/statuses/4e2813b99795d02b1a5476d0bff8ef3528d49fc0"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"ger-benjamin"}}