{"action":"created","comment":{"url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/comments/23922521","id":23922521,"diff_hunk":"@@ -41,40 +44,39 @@ And a list 3rd party libraries (which you can find the installation chapter).\n     When you use Composer to install and update dependencies the\n     installation of these libraries will be handled for your.\n \n-Depending on your needs, you may need the following:\n-\n-* `International <http://www.php.net/manual/en/book.intl.php>`_ support when using Date/Time\n-* `BCMath <http://php.net/manual/en/book.bc.php>`_ or `GNU Multiple Precision (GMP) <http://php.net/manual/en/book.gmp.php>`_ for handling big numbers\n-* `Doctrine ORM <http://www.doctrine-project.org/projects/orm.html>`_ for database support\n-\n Component Breakdown\n -------------------\n \n-The Search Component is made up of many classes. Each of these classes can be grouped\n-into a general \"component\" group which describes the task it is designed to\n+RollerworksSearch is made up of many classes. Each of these classes can be grouped\n+into a general \"component group\" which describes the task it is designed to\n perform.\n \n-We'll take a brief look at the components which form the Search Component as a whole,\n+We'll take a brief look at the components which form RollerworksSearch as a whole,\n in this section of the book.\n \n-ValuesGroup and ValuesBag\n-~~~~~~~~~~~~~~~~~~~~~~~~~\n+SearchCondition\n+~~~~~~~~~~~~~~~\n+\n+Each search operation starts with a SearchCondition (``SearchConditionInterface``)\n+consisting of a ``ValuesGroup`` and ``FieldSet`` object.\n \n-At the root of each search there is at least one ``ValuesGroup`` object, containing\n-the field names with there values (as a ``ValuesBag`` object), and optionally subgroups\n+At the root of each SearchCondition is a ``ValuesGroup`` object, containing\n+the values (as ``ValuesBag`` object) per field name and *optionally** subgroups\n (each one being a ``ValuesGroup`` object).\n \n-A ``ValuesGroup`` is 'logically' marked as AND by default, meaning that the search\n-condition will only be true if from each field inside the group a value is true (matching).\n-But it is however possible to mark a group as OR, meaning that at least one field must match and\n-other fields are considered optional.\n+A ``ValuesGroup`` is 'logically' marked as AND by default meaning that the search\n+condition will only be true if: from each field inside the group at least one value\n+is true (matching). But its also possible to mark a group as OR, which means that at\n+least one field must match and other fields are considered optional.\n \n .. note::\n \n-    Subgroups are always threaded as AND to the group there in, but are OR cased to\n-    each other.\n+    Subgroups are always threaded as AND to the head group they there in,","path":"doc/overview.rst","position":101,"original_position":101,"commit_id":"8b2a5556cbe15dce1edefec0528a0f83ea2460b0","original_commit_id":"8b2a5556cbe15dce1edefec0528a0f83ea2460b0","user":{"login":"cordoval","id":328359,"avatar_url":"https://avatars.githubusercontent.com/u/328359?v=3","gravatar_id":"","url":"https://api.github.com/users/cordoval","html_url":"https://github.com/cordoval","followers_url":"https://api.github.com/users/cordoval/followers","following_url":"https://api.github.com/users/cordoval/following{/other_user}","gists_url":"https://api.github.com/users/cordoval/gists{/gist_id}","starred_url":"https://api.github.com/users/cordoval/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/cordoval/subscriptions","organizations_url":"https://api.github.com/users/cordoval/orgs","repos_url":"https://api.github.com/users/cordoval/repos","events_url":"https://api.github.com/users/cordoval/events{/privacy}","received_events_url":"https://api.github.com/users/cordoval/received_events","type":"User","site_admin":false},"body":"treated as ","created_at":"2015-02-02T12:56:37Z","updated_at":"2015-02-02T12:56:37Z","html_url":"https://github.com/rollerworks/RollerworksSearch/pull/44#discussion_r23922521","pull_request_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44","_links":{"self":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/comments/23922521"},"html":{"href":"https://github.com/rollerworks/RollerworksSearch/pull/44#discussion_r23922521"},"pull_request":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44"}}},"pull_request":{"url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44","id":28282887,"html_url":"https://github.com/rollerworks/RollerworksSearch/pull/44","diff_url":"https://github.com/rollerworks/RollerworksSearch/pull/44.diff","patch_url":"https://github.com/rollerworks/RollerworksSearch/pull/44.patch","issue_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/44","number":44,"state":"open","locked":false,"title":"update documentation","user":{"login":"sstok","id":904790,"avatar_url":"https://avatars.githubusercontent.com/u/904790?v=3","gravatar_id":"","url":"https://api.github.com/users/sstok","html_url":"https://github.com/sstok","followers_url":"https://api.github.com/users/sstok/followers","following_url":"https://api.github.com/users/sstok/following{/other_user}","gists_url":"https://api.github.com/users/sstok/gists{/gist_id}","starred_url":"https://api.github.com/users/sstok/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sstok/subscriptions","organizations_url":"https://api.github.com/users/sstok/orgs","repos_url":"https://api.github.com/users/sstok/repos","events_url":"https://api.github.com/users/sstok/events{/privacy}","received_events_url":"https://api.github.com/users/sstok/received_events","type":"User","site_admin":false},"body":"                   \r\n|Q            |A  |\r\n|---          |---|\r\n|Bug Fix?     |yes|\r\n|New Feature? |no |\r\n|BC Breaks?   |no |\r\n|Deprecations?|no |\r\n|Fixed Tickets|   |\r\n|License      |MIT|\r\n\r\nTodo:\r\n\r\n- [ ] Move creating of a field type to a cookbook\r\n- [ ] An more end-user friendly description on using the FilterQuery processor\r\n- [ ] Add documentation on how to create (cookbook) your own:\r\n   - [ ] Input processor and exporter\r\n   - [ ] Condition optimizer\r\n   - [ ] Type extension\r\n- [ ] Reviewing\r\n                   \r\n\r\n","created_at":"2015-01-29T14:35:22Z","updated_at":"2015-02-02T12:56:37Z","closed_at":null,"merged_at":null,"merge_commit_sha":"012e479718073de611825561e6c243e1060de0a2","assignee":null,"milestone":{"url":"https://api.github.com/repos/rollerworks/RollerworksSearch/milestones/6","labels_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/milestones/6/labels","id":901827,"number":6,"title":" v1.0.0-beta5","description":"","creator":{"login":"sstok","id":904790,"avatar_url":"https://avatars.githubusercontent.com/u/904790?v=3","gravatar_id":"","url":"https://api.github.com/users/sstok","html_url":"https://github.com/sstok","followers_url":"https://api.github.com/users/sstok/followers","following_url":"https://api.github.com/users/sstok/following{/other_user}","gists_url":"https://api.github.com/users/sstok/gists{/gist_id}","starred_url":"https://api.github.com/users/sstok/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sstok/subscriptions","organizations_url":"https://api.github.com/users/sstok/orgs","repos_url":"https://api.github.com/users/sstok/repos","events_url":"https://api.github.com/users/sstok/events{/privacy}","received_events_url":"https://api.github.com/users/sstok/received_events","type":"User","site_admin":false},"open_issues":2,"closed_issues":5,"state":"open","created_at":"2014-12-12T15:09:30Z","updated_at":"2015-02-02T10:35:48Z","due_on":null,"closed_at":null},"commits_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44/commits","review_comments_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44/comments","review_comment_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/comments/{number}","comments_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/44/comments","statuses_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/statuses/8b2a5556cbe15dce1edefec0528a0f83ea2460b0","head":{"label":"sstok:doc-update-and-fixes","ref":"doc-update-and-fixes","sha":"8b2a5556cbe15dce1edefec0528a0f83ea2460b0","user":{"login":"sstok","id":904790,"avatar_url":"https://avatars.githubusercontent.com/u/904790?v=3","gravatar_id":"","url":"https://api.github.com/users/sstok","html_url":"https://github.com/sstok","followers_url":"https://api.github.com/users/sstok/followers","following_url":"https://api.github.com/users/sstok/following{/other_user}","gists_url":"https://api.github.com/users/sstok/gists{/gist_id}","starred_url":"https://api.github.com/users/sstok/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sstok/subscriptions","organizations_url":"https://api.github.com/users/sstok/orgs","repos_url":"https://api.github.com/users/sstok/repos","events_url":"https://api.github.com/users/sstok/events{/privacy}","received_events_url":"https://api.github.com/users/sstok/received_events","type":"User","site_admin":false},"repo":{"id":15508793,"name":"RollerworksSearch","full_name":"sstok/RollerworksSearch","owner":{"login":"sstok","id":904790,"avatar_url":"https://avatars.githubusercontent.com/u/904790?v=3","gravatar_id":"","url":"https://api.github.com/users/sstok","html_url":"https://github.com/sstok","followers_url":"https://api.github.com/users/sstok/followers","following_url":"https://api.github.com/users/sstok/following{/other_user}","gists_url":"https://api.github.com/users/sstok/gists{/gist_id}","starred_url":"https://api.github.com/users/sstok/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/sstok/subscriptions","organizations_url":"https://api.github.com/users/sstok/orgs","repos_url":"https://api.github.com/users/sstok/repos","events_url":"https://api.github.com/users/sstok/events{/privacy}","received_events_url":"https://api.github.com/users/sstok/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/sstok/RollerworksSearch","description":"Advanced search-building system - previously known as the RecordFilterBundle","fork":true,"url":"https://api.github.com/repos/sstok/RollerworksSearch","forks_url":"https://api.github.com/repos/sstok/RollerworksSearch/forks","keys_url":"https://api.github.com/repos/sstok/RollerworksSearch/keys{/key_id}","collaborators_url":"https://api.github.com/repos/sstok/RollerworksSearch/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/sstok/RollerworksSearch/teams","hooks_url":"https://api.github.com/repos/sstok/RollerworksSearch/hooks","issue_events_url":"https://api.github.com/repos/sstok/RollerworksSearch/issues/events{/number}","events_url":"https://api.github.com/repos/sstok/RollerworksSearch/events","assignees_url":"https://api.github.com/repos/sstok/RollerworksSearch/assignees{/user}","branches_url":"https://api.github.com/repos/sstok/RollerworksSearch/branches{/branch}","tags_url":"https://api.github.com/repos/sstok/RollerworksSearch/tags","blobs_url":"https://api.github.com/repos/sstok/RollerworksSearch/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/sstok/RollerworksSearch/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/sstok/RollerworksSearch/git/refs{/sha}","trees_url":"https://api.github.com/repos/sstok/RollerworksSearch/git/trees{/sha}","statuses_url":"https://api.github.com/repos/sstok/RollerworksSearch/statuses/{sha}","languages_url":"https://api.github.com/repos/sstok/RollerworksSearch/languages","stargazers_url":"https://api.github.com/repos/sstok/RollerworksSearch/stargazers","contributors_url":"https://api.github.com/repos/sstok/RollerworksSearch/contributors","subscribers_url":"https://api.github.com/repos/sstok/RollerworksSearch/subscribers","subscription_url":"https://api.github.com/repos/sstok/RollerworksSearch/subscription","commits_url":"https://api.github.com/repos/sstok/RollerworksSearch/commits{/sha}","git_commits_url":"https://api.github.com/repos/sstok/RollerworksSearch/git/commits{/sha}","comments_url":"https://api.github.com/repos/sstok/RollerworksSearch/comments{/number}","issue_comment_url":"https://api.github.com/repos/sstok/RollerworksSearch/issues/comments/{number}","contents_url":"https://api.github.com/repos/sstok/RollerworksSearch/contents/{+path}","compare_url":"https://api.github.com/repos/sstok/RollerworksSearch/compare/{base}...{head}","merges_url":"https://api.github.com/repos/sstok/RollerworksSearch/merges","archive_url":"https://api.github.com/repos/sstok/RollerworksSearch/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/sstok/RollerworksSearch/downloads","issues_url":"https://api.github.com/repos/sstok/RollerworksSearch/issues{/number}","pulls_url":"https://api.github.com/repos/sstok/RollerworksSearch/pulls{/number}","milestones_url":"https://api.github.com/repos/sstok/RollerworksSearch/milestones{/number}","notifications_url":"https://api.github.com/repos/sstok/RollerworksSearch/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/sstok/RollerworksSearch/labels{/name}","releases_url":"https://api.github.com/repos/sstok/RollerworksSearch/releases{/id}","created_at":"2013-12-29T13:26:30Z","updated_at":"2015-02-02T11:05:55Z","pushed_at":"2015-02-02T11:05:55Z","git_url":"git://github.com/sstok/RollerworksSearch.git","ssh_url":"git@github.com:sstok/RollerworksSearch.git","clone_url":"https://github.com/sstok/RollerworksSearch.git","svn_url":"https://github.com/sstok/RollerworksSearch","homepage":"","size":2162,"stargazers_count":0,"watchers_count":0,"language":"PHP","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":0,"mirror_url":null,"open_issues_count":0,"forks":0,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"rollerworks:master","ref":"master","sha":"bf9505dbb304c4b77a9888fdf9a287513a6b04b1","user":{"login":"rollerworks","id":1769921,"avatar_url":"https://avatars.githubusercontent.com/u/1769921?v=3","gravatar_id":"","url":"https://api.github.com/users/rollerworks","html_url":"https://github.com/rollerworks","followers_url":"https://api.github.com/users/rollerworks/followers","following_url":"https://api.github.com/users/rollerworks/following{/other_user}","gists_url":"https://api.github.com/users/rollerworks/gists{/gist_id}","starred_url":"https://api.github.com/users/rollerworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rollerworks/subscriptions","organizations_url":"https://api.github.com/users/rollerworks/orgs","repos_url":"https://api.github.com/users/rollerworks/repos","events_url":"https://api.github.com/users/rollerworks/events{/privacy}","received_events_url":"https://api.github.com/users/rollerworks/received_events","type":"Organization","site_admin":false},"repo":{"id":11894231,"name":"RollerworksSearch","full_name":"rollerworks/RollerworksSearch","owner":{"login":"rollerworks","id":1769921,"avatar_url":"https://avatars.githubusercontent.com/u/1769921?v=3","gravatar_id":"","url":"https://api.github.com/users/rollerworks","html_url":"https://github.com/rollerworks","followers_url":"https://api.github.com/users/rollerworks/followers","following_url":"https://api.github.com/users/rollerworks/following{/other_user}","gists_url":"https://api.github.com/users/rollerworks/gists{/gist_id}","starred_url":"https://api.github.com/users/rollerworks/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/rollerworks/subscriptions","organizations_url":"https://api.github.com/users/rollerworks/orgs","repos_url":"https://api.github.com/users/rollerworks/repos","events_url":"https://api.github.com/users/rollerworks/events{/privacy}","received_events_url":"https://api.github.com/users/rollerworks/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/rollerworks/RollerworksSearch","description":"An easy to implement powerful search system for PHP","fork":false,"url":"https://api.github.com/repos/rollerworks/RollerworksSearch","forks_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/forks","keys_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/keys{/key_id}","collaborators_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/teams","hooks_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/hooks","issue_events_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/events{/number}","events_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/events","assignees_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/assignees{/user}","branches_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/branches{/branch}","tags_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/tags","blobs_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/git/refs{/sha}","trees_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/git/trees{/sha}","statuses_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/statuses/{sha}","languages_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/languages","stargazers_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/stargazers","contributors_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/contributors","subscribers_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/subscribers","subscription_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/subscription","commits_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/commits{/sha}","git_commits_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/git/commits{/sha}","comments_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/comments{/number}","issue_comment_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/comments/{number}","contents_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/contents/{+path}","compare_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/compare/{base}...{head}","merges_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/merges","archive_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/downloads","issues_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues{/number}","pulls_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls{/number}","milestones_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/milestones{/number}","notifications_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/labels{/name}","releases_url":"https://api.github.com/repos/rollerworks/RollerworksSearch/releases{/id}","created_at":"2013-08-05T09:03:44Z","updated_at":"2015-02-02T10:48:36Z","pushed_at":"2015-02-02T10:48:36Z","git_url":"git://github.com/rollerworks/RollerworksSearch.git","ssh_url":"git@github.com:rollerworks/RollerworksSearch.git","clone_url":"https://github.com/rollerworks/RollerworksSearch.git","svn_url":"https://github.com/rollerworks/RollerworksSearch","homepage":"","size":2596,"stargazers_count":10,"watchers_count":10,"language":"PHP","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":3,"mirror_url":null,"open_issues_count":6,"forks":3,"open_issues":6,"watchers":10,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44"},"html":{"href":"https://github.com/rollerworks/RollerworksSearch/pull/44"},"issue":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/44"},"comments":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/issues/44/comments"},"review_comments":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44/comments"},"review_comment":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/comments/{number}"},"commits":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/pulls/44/commits"},"statuses":{"href":"https://api.github.com/repos/rollerworks/RollerworksSearch/statuses/8b2a5556cbe15dce1edefec0528a0f83ea2460b0"}}}}