{"action":"created","comment":{"url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/comments/168694111","pull_request_review_id":97103695,"id":168694111,"diff_hunk":"@@ -569,14 +569,21 @@ Many human planners fail to accept this, often because they feel threatened by a\n \n But despite that, both can benefit if the human planner becomes the supervisor of Planner:\n \n-* *The human planner defines and validates the score function.*\n-** Some examples expose a `\\*Parametrization` object, which defines the weight for each score constraint. The human planner can then tweak those weights at runtime.\n-** When the business changes, the score function often needs to change too. The human planner can notify the developers to add, change or remove score constraints.\n+* *The human planner defines, validates and tweaks the score function.*\n+** Some examples expose a `Parametrization` object, which defines the weight for each score constraint.\n+The human planner can then tweak those weights at runtime.\n+** When the business changes, the score function often needs to change too.\n+The human planner can notify the developers to add, change or remove score constraints.\n * *The human planner is always in control of Planner.*\n-** As shown in the course scheduling example, the human planner can lock one or more planning variables to a specific planning value and make those immovable. Because they are <<immovablePlanningEntities,immovable>>, Planner does not change them: it optimizes the planning around the enforcements made by the human. If the human planner locks all planning variables, he/she sidelines Planner completely.\n-** In a prototype implementation, the human planner might use this occasionally. But as the implementation matures, it must become obsolete. But do keep the feature alive: as a reassurance for the humans. Or in case that one day the business changes dramatically before the score constraints can be adjusted.\n-\n-Therefore, it's often a good idea to involve the human planner in your project.\n+** As shown in the course scheduling example, the human planner can pin down one or more planning variables to a specific planning value.\n+Because they are <<immovablePlanningEntities,immovable>>, Planner does not change them: it optimizes the planning around the enforcements made by the human.\n+If the human planner pins down all planning variables, he/she sidelines Planner completely.\n+** In a prototype implementation, the human planner will use pinning occasionally to intervene.\n+But as the implementation matures, it should become obsolete.\n+But do keep the feature alive, as a reassurance for the humans.\n+Or in case that one day the business changes dramatically before the score constraints are adjusted accordingly.\n+\n+Therefore, it's often a good idea to actively involve the human planner in your project.","path":"optaplanner-docs/src/main/asciidoc/Integration/Integration-chapter.adoc","position":25,"original_position":25,"commit_id":"813b1c26f00ee1c07493908277af03f6ec1afa67","original_commit_id":"813b1c26f00ee1c07493908277af03f6ec1afa67","user":{"login":"ge0ffrey","id":176880,"avatar_url":"https://avatars1.githubusercontent.com/u/176880?v=4","gravatar_id":"","url":"https://api.github.com/users/ge0ffrey","html_url":"https://github.com/ge0ffrey","followers_url":"https://api.github.com/users/ge0ffrey/followers","following_url":"https://api.github.com/users/ge0ffrey/following{/other_user}","gists_url":"https://api.github.com/users/ge0ffrey/gists{/gist_id}","starred_url":"https://api.github.com/users/ge0ffrey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ge0ffrey/subscriptions","organizations_url":"https://api.github.com/users/ge0ffrey/orgs","repos_url":"https://api.github.com/users/ge0ffrey/repos","events_url":"https://api.github.com/users/ge0ffrey/events{/privacy}","received_events_url":"https://api.github.com/users/ge0ffrey/received_events","type":"User","site_admin":false},"body":"Thanks Gemma, fixed accordingly.","created_at":"2018-02-16T08:13:11Z","updated_at":"2018-02-16T08:13:11Z","html_url":"https://github.com/kiegroup/optaplanner/pull/373#discussion_r168694111","pull_request_url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373","author_association":"OWNER","_links":{"self":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/comments/168694111"},"html":{"href":"https://github.com/kiegroup/optaplanner/pull/373#discussion_r168694111"},"pull_request":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373"}},"in_reply_to_id":168381327},"pull_request":{"url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373","id":168814253,"html_url":"https://github.com/kiegroup/optaplanner/pull/373","diff_url":"https://github.com/kiegroup/optaplanner/pull/373.diff","patch_url":"https://github.com/kiegroup/optaplanner/pull/373.patch","issue_url":"https://api.github.com/repos/kiegroup/optaplanner/issues/373","number":373,"state":"closed","locked":false,"title":"PLANNER-969 @PlanningPin on boolean field of entity to make it immovable","user":{"login":"ge0ffrey","id":176880,"avatar_url":"https://avatars1.githubusercontent.com/u/176880?v=4","gravatar_id":"","url":"https://api.github.com/users/ge0ffrey","html_url":"https://github.com/ge0ffrey","followers_url":"https://api.github.com/users/ge0ffrey/followers","following_url":"https://api.github.com/users/ge0ffrey/following{/other_user}","gists_url":"https://api.github.com/users/ge0ffrey/gists{/gist_id}","starred_url":"https://api.github.com/users/ge0ffrey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ge0ffrey/subscriptions","organizations_url":"https://api.github.com/users/ge0ffrey/orgs","repos_url":"https://api.github.com/users/ge0ffrey/repos","events_url":"https://api.github.com/users/ge0ffrey/events{/privacy}","received_events_url":"https://api.github.com/users/ge0ffrey/received_events","type":"User","site_admin":false},"body":"","created_at":"2018-02-13T11:01:56Z","updated_at":"2018-02-16T08:13:11Z","closed_at":"2018-02-13T15:08:17Z","merged_at":"2018-02-13T15:08:17Z","merge_commit_sha":"973a25aaf1e55db0498246152affa754fa7c29ec","assignee":null,"assignees":[],"requested_reviewers":[{"login":"rsynek","id":1422582,"avatar_url":"https://avatars0.githubusercontent.com/u/1422582?v=4","gravatar_id":"","url":"https://api.github.com/users/rsynek","html_url":"https://github.com/rsynek","followers_url":"https://api.github.com/users/rsynek/followers","following_url":"https://api.github.com/users/rsynek/following{/other_user}","gists_url":"https://api.github.com/users/rsynek/gists{/gist_id}","starred_url":"https://api.github.com/users/rsynek/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rsynek/subscriptions","organizations_url":"https://api.github.com/users/rsynek/orgs","repos_url":"https://api.github.com/users/rsynek/repos","events_url":"https://api.github.com/users/rsynek/events{/privacy}","received_events_url":"https://api.github.com/users/rsynek/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373/commits","review_comments_url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373/comments","review_comment_url":"https://api.github.com/repos/kiegroup/optaplanner/pulls/comments{/number}","comments_url":"https://api.github.com/repos/kiegroup/optaplanner/issues/373/comments","statuses_url":"https://api.github.com/repos/kiegroup/optaplanner/statuses/813b1c26f00ee1c07493908277af03f6ec1afa67","head":{"label":"ge0ffrey:PlanningPin-PLANNER-969","ref":"PlanningPin-PLANNER-969","sha":"813b1c26f00ee1c07493908277af03f6ec1afa67","user":{"login":"ge0ffrey","id":176880,"avatar_url":"https://avatars1.githubusercontent.com/u/176880?v=4","gravatar_id":"","url":"https://api.github.com/users/ge0ffrey","html_url":"https://github.com/ge0ffrey","followers_url":"https://api.github.com/users/ge0ffrey/followers","following_url":"https://api.github.com/users/ge0ffrey/following{/other_user}","gists_url":"https://api.github.com/users/ge0ffrey/gists{/gist_id}","starred_url":"https://api.github.com/users/ge0ffrey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ge0ffrey/subscriptions","organizations_url":"https://api.github.com/users/ge0ffrey/orgs","repos_url":"https://api.github.com/users/ge0ffrey/repos","events_url":"https://api.github.com/users/ge0ffrey/events{/privacy}","received_events_url":"https://api.github.com/users/ge0ffrey/received_events","type":"User","site_admin":false},"repo":{"id":1792278,"name":"optaplanner","full_name":"ge0ffrey/optaplanner","owner":{"login":"ge0ffrey","id":176880,"avatar_url":"https://avatars1.githubusercontent.com/u/176880?v=4","gravatar_id":"","url":"https://api.github.com/users/ge0ffrey","html_url":"https://github.com/ge0ffrey","followers_url":"https://api.github.com/users/ge0ffrey/followers","following_url":"https://api.github.com/users/ge0ffrey/following{/other_user}","gists_url":"https://api.github.com/users/ge0ffrey/gists{/gist_id}","starred_url":"https://api.github.com/users/ge0ffrey/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/ge0ffrey/subscriptions","organizations_url":"https://api.github.com/users/ge0ffrey/orgs","repos_url":"https://api.github.com/users/ge0ffrey/repos","events_url":"https://api.github.com/users/ge0ffrey/events{/privacy}","received_events_url":"https://api.github.com/users/ge0ffrey/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/ge0ffrey/optaplanner","description":"Drools Planner optimizes automated planning.","fork":true,"url":"https://api.github.com/repos/ge0ffrey/optaplanner","forks_url":"https://api.github.com/repos/ge0ffrey/optaplanner/forks","keys_url":"https://api.github.com/repos/ge0ffrey/optaplanner/keys{/key_id}","collaborators_url":"https://api.github.com/repos/ge0ffrey/optaplanner/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/ge0ffrey/optaplanner/teams","hooks_url":"https://api.github.com/repos/ge0ffrey/optaplanner/hooks","issue_events_url":"https://api.github.com/repos/ge0ffrey/optaplanner/issues/events{/number}","events_url":"https://api.github.com/repos/ge0ffrey/optaplanner/events","assignees_url":"https://api.github.com/repos/ge0ffrey/optaplanner/assignees{/user}","branches_url":"https://api.github.com/repos/ge0ffrey/optaplanner/branches{/branch}","tags_url":"https://api.github.com/repos/ge0ffrey/optaplanner/tags","blobs_url":"https://api.github.com/repos/ge0ffrey/optaplanner/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/ge0ffrey/optaplanner/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/ge0ffrey/optaplanner/git/refs{/sha}","trees_url":"https://api.github.com/repos/ge0ffrey/optaplanner/git/trees{/sha}","statuses_url":"https://api.github.com/repos/ge0ffrey/optaplanner/statuses/{sha}","languages_url":"https://api.github.com/repos/ge0ffrey/optaplanner/languages","stargazers_url":"https://api.github.com/repos/ge0ffrey/optaplanner/stargazers","contributors_url":"https://api.github.com/repos/ge0ffrey/optaplanner/contributors","subscribers_url":"https://api.github.com/repos/ge0ffrey/optaplanner/subscribers","subscription_url":"https://api.github.com/repos/ge0ffrey/optaplanner/subscription","commits_url":"https://api.github.com/repos/ge0ffrey/optaplanner/commits{/sha}","git_commits_url":"https://api.github.com/repos/ge0ffrey/optaplanner/git/commits{/sha}","comments_url":"https://api.github.com/repos/ge0ffrey/optaplanner/comments{/number}","issue_comment_url":"https://api.github.com/repos/ge0ffrey/optaplanner/issues/comments{/number}","contents_url":"https://api.github.com/repos/ge0ffrey/optaplanner/contents/{+path}","compare_url":"https://api.github.com/repos/ge0ffrey/optaplanner/compare/{base}...{head}","merges_url":"https://api.github.com/repos/ge0ffrey/optaplanner/merges","archive_url":"https://api.github.com/repos/ge0ffrey/optaplanner/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/ge0ffrey/optaplanner/downloads","issues_url":"https://api.github.com/repos/ge0ffrey/optaplanner/issues{/number}","pulls_url":"https://api.github.com/repos/ge0ffrey/optaplanner/pulls{/number}","milestones_url":"https://api.github.com/repos/ge0ffrey/optaplanner/milestones{/number}","notifications_url":"https://api.github.com/repos/ge0ffrey/optaplanner/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/ge0ffrey/optaplanner/labels{/name}","releases_url":"https://api.github.com/repos/ge0ffrey/optaplanner/releases{/id}","deployments_url":"https://api.github.com/repos/ge0ffrey/optaplanner/deployments","created_at":"2011-05-24T07:49:08Z","updated_at":"2017-08-19T03:30:50Z","pushed_at":"2018-02-13T13:28:07Z","git_url":"git://github.com/ge0ffrey/optaplanner.git","ssh_url":"git@github.com:ge0ffrey/optaplanner.git","clone_url":"https://github.com/ge0ffrey/optaplanner.git","svn_url":"https://github.com/ge0ffrey/optaplanner","homepage":"http://www.jboss.org/drools/drools-planner","size":165762,"stargazers_count":8,"watchers_count":8,"language":"Java","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"archived":false,"open_issues_count":0,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":0,"open_issues":0,"watchers":8,"default_branch":"master"}},"base":{"label":"kiegroup:master","ref":"master","sha":"5c33d3c0490b5d42a40178b76003874a363b720b","user":{"login":"kiegroup","id":517980,"avatar_url":"https://avatars3.githubusercontent.com/u/517980?v=4","gravatar_id":"","url":"https://api.github.com/users/kiegroup","html_url":"https://github.com/kiegroup","followers_url":"https://api.github.com/users/kiegroup/followers","following_url":"https://api.github.com/users/kiegroup/following{/other_user}","gists_url":"https://api.github.com/users/kiegroup/gists{/gist_id}","starred_url":"https://api.github.com/users/kiegroup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kiegroup/subscriptions","organizations_url":"https://api.github.com/users/kiegroup/orgs","repos_url":"https://api.github.com/users/kiegroup/repos","events_url":"https://api.github.com/users/kiegroup/events{/privacy}","received_events_url":"https://api.github.com/users/kiegroup/received_events","type":"Organization","site_admin":false},"repo":{"id":1370858,"name":"optaplanner","full_name":"kiegroup/optaplanner","owner":{"login":"kiegroup","id":517980,"avatar_url":"https://avatars3.githubusercontent.com/u/517980?v=4","gravatar_id":"","url":"https://api.github.com/users/kiegroup","html_url":"https://github.com/kiegroup","followers_url":"https://api.github.com/users/kiegroup/followers","following_url":"https://api.github.com/users/kiegroup/following{/other_user}","gists_url":"https://api.github.com/users/kiegroup/gists{/gist_id}","starred_url":"https://api.github.com/users/kiegroup/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/kiegroup/subscriptions","organizations_url":"https://api.github.com/users/kiegroup/orgs","repos_url":"https://api.github.com/users/kiegroup/repos","events_url":"https://api.github.com/users/kiegroup/events{/privacy}","received_events_url":"https://api.github.com/users/kiegroup/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/kiegroup/optaplanner","description":"Java Constraint Solver to solve vehicle routing, employee rostering and other planning problems.","fork":false,"url":"https://api.github.com/repos/kiegroup/optaplanner","forks_url":"https://api.github.com/repos/kiegroup/optaplanner/forks","keys_url":"https://api.github.com/repos/kiegroup/optaplanner/keys{/key_id}","collaborators_url":"https://api.github.com/repos/kiegroup/optaplanner/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/kiegroup/optaplanner/teams","hooks_url":"https://api.github.com/repos/kiegroup/optaplanner/hooks","issue_events_url":"https://api.github.com/repos/kiegroup/optaplanner/issues/events{/number}","events_url":"https://api.github.com/repos/kiegroup/optaplanner/events","assignees_url":"https://api.github.com/repos/kiegroup/optaplanner/assignees{/user}","branches_url":"https://api.github.com/repos/kiegroup/optaplanner/branches{/branch}","tags_url":"https://api.github.com/repos/kiegroup/optaplanner/tags","blobs_url":"https://api.github.com/repos/kiegroup/optaplanner/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/kiegroup/optaplanner/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/kiegroup/optaplanner/git/refs{/sha}","trees_url":"https://api.github.com/repos/kiegroup/optaplanner/git/trees{/sha}","statuses_url":"https://api.github.com/repos/kiegroup/optaplanner/statuses/{sha}","languages_url":"https://api.github.com/repos/kiegroup/optaplanner/languages","stargazers_url":"https://api.github.com/repos/kiegroup/optaplanner/stargazers","contributors_url":"https://api.github.com/repos/kiegroup/optaplanner/contributors","subscribers_url":"https://api.github.com/repos/kiegroup/optaplanner/subscribers","subscription_url":"https://api.github.com/repos/kiegroup/optaplanner/subscription","commits_url":"https://api.github.com/repos/kiegroup/optaplanner/commits{/sha}","git_commits_url":"https://api.github.com/repos/kiegroup/optaplanner/git/commits{/sha}","comments_url":"https://api.github.com/repos/kiegroup/optaplanner/comments{/number}","issue_comment_url":"https://api.github.com/repos/kiegroup/optaplanner/issues/comments{/number}","contents_url":"https://api.github.com/repos/kiegroup/optaplanner/contents/{+path}","compare_url":"https://api.github.com/repos/kiegroup/optaplanner/compare/{base}...{head}","merges_url":"https://api.github.com/repos/kiegroup/optaplanner/merges","archive_url":"https://api.github.com/repos/kiegroup/optaplanner/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/kiegroup/optaplanner/downloads","issues_url":"https://api.github.com/repos/kiegroup/optaplanner/issues{/number}","pulls_url":"https://api.github.com/repos/kiegroup/optaplanner/pulls{/number}","milestones_url":"https://api.github.com/repos/kiegroup/optaplanner/milestones{/number}","notifications_url":"https://api.github.com/repos/kiegroup/optaplanner/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/kiegroup/optaplanner/labels{/name}","releases_url":"https://api.github.com/repos/kiegroup/optaplanner/releases{/id}","deployments_url":"https://api.github.com/repos/kiegroup/optaplanner/deployments","created_at":"2011-02-15T19:38:23Z","updated_at":"2018-02-15T11:13:56Z","pushed_at":"2018-02-16T08:12:49Z","git_url":"git://github.com/kiegroup/optaplanner.git","ssh_url":"git@github.com:kiegroup/optaplanner.git","clone_url":"https://github.com/kiegroup/optaplanner.git","svn_url":"https://github.com/kiegroup/optaplanner","homepage":"https://www.optaplanner.org","size":166170,"stargazers_count":780,"watchers_count":780,"language":"Java","has_issues":false,"has_projects":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":410,"mirror_url":null,"archived":false,"open_issues_count":4,"license":{"key":"apache-2.0","name":"Apache License 2.0","spdx_id":"Apache-2.0","url":"https://api.github.com/licenses/apache-2.0"},"forks":410,"open_issues":4,"watchers":780,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373"},"html":{"href":"https://github.com/kiegroup/optaplanner/pull/373"},"issue":{"href":"https://api.github.com/repos/kiegroup/optaplanner/issues/373"},"comments":{"href":"https://api.github.com/repos/kiegroup/optaplanner/issues/373/comments"},"review_comments":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373/comments"},"review_comment":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/kiegroup/optaplanner/pulls/373/commits"},"statuses":{"href":"https://api.github.com/repos/kiegroup/optaplanner/statuses/813b1c26f00ee1c07493908277af03f6ec1afa67"}},"author_association":"OWNER"}}
{"actor":{"display_login":"ge0ffrey"}}