{"action":"created","comment":{"url":"https://api.github.com/repos/opendatakit/docs/pulls/comments/179925407","pull_request_review_id":110264507,"id":179925407,"diff_hunk":"@@ -0,0 +1,57 @@\n+.. spelling::\n+  prepopulated\n+\n+Follow Up Forms\n+=======================\n+\n+.. image:: /img/hope-study-tour/hope-study-follow-up-forms.*\n+  :alt: Main Menu\n+  :class: device-screen-vertical\n+\n+.. _hope-study-tour-follow-up-forms-function:\n+\n+Function\n+---------------------\n+\n+The follow up forms are the bulk of the longitudinal study. After clients are screened and entered into the study, six week and six month follow ups will take place. Furthermore, their partner may be screened to enter the study with them, and also receive a six month follow up.\n+\n+Each of these are launched from the :doc:`hope-study-tour-client-details` module. They are survey forms that provide the interviewer with a script and ask detailed medical questions. Some previously collected data will be prepopulated in the forms prompts.\n+\n+.. _hope-study-tour-follow-up-forms-implementation:\n+\n+Implementation\n+-----------------------\n+\n+The two :guilabel:`Client Forms` both read and write from the *femaleClients* table (as can be seen on the *settings* worksheet of both forms). This is true for both :guilabel:`Partner Forms` and the *maleClients* table as well.\n+\n+These surveys are similar in structure to the initial :doc:`hope-study-tour-screen-client` form. There is basic navigation logic via :tc:`if` and :th:`condition` clauses. Simple data collection occurs with :tc:`select_one`, :tc:`select_multiple`, :tc:`integer`, :tc:`decimal`, :tc:`text:`, and :tc:`date` prompts. Interviewer scripts are provided with :tc:`note` prompts. The client ID is marked as necessary with the :th:`required:` column, however, this field should always be prepopulated in follow up forms. This is because the form is modifying an existing record in the database, and the field already has a value. In general this could be changed, though in this workflow this would be rare. The *model* worksheet provides the linkage with the database table.","path":"odk2-src/hope-study-tour-follow-up-forms.rst","position":27,"original_position":27,"commit_id":"178d00a63c884831460bd19b7aba4ac77db4c42e","original_commit_id":"178d00a63c884831460bd19b7aba4ac77db4c42e","user":{"login":"linl33","id":8204095,"avatar_url":"https://avatars1.githubusercontent.com/u/8204095?v=4","gravatar_id":"","url":"https://api.github.com/users/linl33","html_url":"https://github.com/linl33","followers_url":"https://api.github.com/users/linl33/followers","following_url":"https://api.github.com/users/linl33/following{/other_user}","gists_url":"https://api.github.com/users/linl33/gists{/gist_id}","starred_url":"https://api.github.com/users/linl33/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/linl33/subscriptions","organizations_url":"https://api.github.com/users/linl33/orgs","repos_url":"https://api.github.com/users/linl33/repos","events_url":"https://api.github.com/users/linl33/events{/privacy}","received_events_url":"https://api.github.com/users/linl33/received_events","type":"User","site_admin":false},"body":"Extra semicolon `` :tc:`text:` ``","created_at":"2018-04-07T19:12:06Z","updated_at":"2018-04-07T19:12:07Z","html_url":"https://github.com/opendatakit/docs/pull/633#discussion_r179925407","pull_request_url":"https://api.github.com/repos/opendatakit/docs/pulls/633","author_association":"MEMBER","_links":{"self":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/comments/179925407"},"html":{"href":"https://github.com/opendatakit/docs/pull/633#discussion_r179925407"},"pull_request":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/633"}}},"pull_request":{"url":"https://api.github.com/repos/opendatakit/docs/pulls/633","id":180018132,"html_url":"https://github.com/opendatakit/docs/pull/633","diff_url":"https://github.com/opendatakit/docs/pull/633.diff","patch_url":"https://github.com/opendatakit/docs/pull/633.patch","issue_url":"https://api.github.com/repos/opendatakit/docs/issues/633","number":633,"state":"open","locked":false,"title":"Add application building section","user":{"login":"jbeorse","id":334255,"avatar_url":"https://avatars1.githubusercontent.com/u/334255?v=4","gravatar_id":"","url":"https://api.github.com/users/jbeorse","html_url":"https://github.com/jbeorse","followers_url":"https://api.github.com/users/jbeorse/followers","following_url":"https://api.github.com/users/jbeorse/following{/other_user}","gists_url":"https://api.github.com/users/jbeorse/gists{/gist_id}","starred_url":"https://api.github.com/users/jbeorse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jbeorse/subscriptions","organizations_url":"https://api.github.com/users/jbeorse/orgs","repos_url":"https://api.github.com/users/jbeorse/repos","events_url":"https://api.github.com/users/jbeorse/events{/privacy}","received_events_url":"https://api.github.com/users/jbeorse/received_events","type":"User","site_admin":false},"body":"closes #589 \r\naddresses #593\r\n\r\n\r\n## What is included in this PR?\r\nThis PR adds an \"Application Building\" section similar to the \"Form Building\" section in ODK 1. Some of this is rearranging of existing material, including the XLSX Converter and the Injected Interfaces. Much of it is newly written, including a walkthrough of building and deploying and application from scratch, and documentation for each of the reference applications.\r\n","created_at":"2018-04-06T18:13:13Z","updated_at":"2018-04-07T19:12:07Z","closed_at":null,"merged_at":null,"merge_commit_sha":"abca143dd253b2a7266e52de89f52b52f2836a86","assignee":null,"assignees":[],"requested_reviewers":[{"login":"wbrunette","id":11892715,"avatar_url":"https://avatars2.githubusercontent.com/u/11892715?v=4","gravatar_id":"","url":"https://api.github.com/users/wbrunette","html_url":"https://github.com/wbrunette","followers_url":"https://api.github.com/users/wbrunette/followers","following_url":"https://api.github.com/users/wbrunette/following{/other_user}","gists_url":"https://api.github.com/users/wbrunette/gists{/gist_id}","starred_url":"https://api.github.com/users/wbrunette/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/wbrunette/subscriptions","organizations_url":"https://api.github.com/users/wbrunette/orgs","repos_url":"https://api.github.com/users/wbrunette/repos","events_url":"https://api.github.com/users/wbrunette/events{/privacy}","received_events_url":"https://api.github.com/users/wbrunette/received_events","type":"User","site_admin":false}],"requested_teams":[],"labels":[],"milestone":null,"commits_url":"https://api.github.com/repos/opendatakit/docs/pulls/633/commits","review_comments_url":"https://api.github.com/repos/opendatakit/docs/pulls/633/comments","review_comment_url":"https://api.github.com/repos/opendatakit/docs/pulls/comments{/number}","comments_url":"https://api.github.com/repos/opendatakit/docs/issues/633/comments","statuses_url":"https://api.github.com/repos/opendatakit/docs/statuses/178d00a63c884831460bd19b7aba4ac77db4c42e","head":{"label":"jbeorse:app-building","ref":"app-building","sha":"178d00a63c884831460bd19b7aba4ac77db4c42e","user":{"login":"jbeorse","id":334255,"avatar_url":"https://avatars1.githubusercontent.com/u/334255?v=4","gravatar_id":"","url":"https://api.github.com/users/jbeorse","html_url":"https://github.com/jbeorse","followers_url":"https://api.github.com/users/jbeorse/followers","following_url":"https://api.github.com/users/jbeorse/following{/other_user}","gists_url":"https://api.github.com/users/jbeorse/gists{/gist_id}","starred_url":"https://api.github.com/users/jbeorse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jbeorse/subscriptions","organizations_url":"https://api.github.com/users/jbeorse/orgs","repos_url":"https://api.github.com/users/jbeorse/repos","events_url":"https://api.github.com/users/jbeorse/events{/privacy}","received_events_url":"https://api.github.com/users/jbeorse/received_events","type":"User","site_admin":false},"repo":{"id":117796893,"name":"docs","full_name":"jbeorse/docs","owner":{"login":"jbeorse","id":334255,"avatar_url":"https://avatars1.githubusercontent.com/u/334255?v=4","gravatar_id":"","url":"https://api.github.com/users/jbeorse","html_url":"https://github.com/jbeorse","followers_url":"https://api.github.com/users/jbeorse/followers","following_url":"https://api.github.com/users/jbeorse/following{/other_user}","gists_url":"https://api.github.com/users/jbeorse/gists{/gist_id}","starred_url":"https://api.github.com/users/jbeorse/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/jbeorse/subscriptions","organizations_url":"https://api.github.com/users/jbeorse/orgs","repos_url":"https://api.github.com/users/jbeorse/repos","events_url":"https://api.github.com/users/jbeorse/events{/privacy}","received_events_url":"https://api.github.com/users/jbeorse/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/jbeorse/docs","description":"Open Data Kit Documentation, built in Sphinx.","fork":true,"url":"https://api.github.com/repos/jbeorse/docs","forks_url":"https://api.github.com/repos/jbeorse/docs/forks","keys_url":"https://api.github.com/repos/jbeorse/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/jbeorse/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/jbeorse/docs/teams","hooks_url":"https://api.github.com/repos/jbeorse/docs/hooks","issue_events_url":"https://api.github.com/repos/jbeorse/docs/issues/events{/number}","events_url":"https://api.github.com/repos/jbeorse/docs/events","assignees_url":"https://api.github.com/repos/jbeorse/docs/assignees{/user}","branches_url":"https://api.github.com/repos/jbeorse/docs/branches{/branch}","tags_url":"https://api.github.com/repos/jbeorse/docs/tags","blobs_url":"https://api.github.com/repos/jbeorse/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/jbeorse/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/jbeorse/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/jbeorse/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/jbeorse/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/jbeorse/docs/languages","stargazers_url":"https://api.github.com/repos/jbeorse/docs/stargazers","contributors_url":"https://api.github.com/repos/jbeorse/docs/contributors","subscribers_url":"https://api.github.com/repos/jbeorse/docs/subscribers","subscription_url":"https://api.github.com/repos/jbeorse/docs/subscription","commits_url":"https://api.github.com/repos/jbeorse/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/jbeorse/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/jbeorse/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/jbeorse/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/jbeorse/docs/contents/{+path}","compare_url":"https://api.github.com/repos/jbeorse/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/jbeorse/docs/merges","archive_url":"https://api.github.com/repos/jbeorse/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/jbeorse/docs/downloads","issues_url":"https://api.github.com/repos/jbeorse/docs/issues{/number}","pulls_url":"https://api.github.com/repos/jbeorse/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/jbeorse/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/jbeorse/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/jbeorse/docs/labels{/name}","releases_url":"https://api.github.com/repos/jbeorse/docs/releases{/id}","deployments_url":"https://api.github.com/repos/jbeorse/docs/deployments","created_at":"2018-01-17T06:51:09Z","updated_at":"2018-04-06T18:08:20Z","pushed_at":"2018-04-06T19:52:43Z","git_url":"git://github.com/jbeorse/docs.git","ssh_url":"git@github.com:jbeorse/docs.git","clone_url":"https://github.com/jbeorse/docs.git","svn_url":"https://github.com/jbeorse/docs","homepage":"http://docs.opendatakit.org/","size":1491,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1,"mirror_url":null,"archived":false,"open_issues_count":0,"license":null,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"opendatakit:master","ref":"master","sha":"90382e3e729a7fed94d48eda9bf618b5e981ae35","user":{"login":"opendatakit","id":6222985,"avatar_url":"https://avatars0.githubusercontent.com/u/6222985?v=4","gravatar_id":"","url":"https://api.github.com/users/opendatakit","html_url":"https://github.com/opendatakit","followers_url":"https://api.github.com/users/opendatakit/followers","following_url":"https://api.github.com/users/opendatakit/following{/other_user}","gists_url":"https://api.github.com/users/opendatakit/gists{/gist_id}","starred_url":"https://api.github.com/users/opendatakit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opendatakit/subscriptions","organizations_url":"https://api.github.com/users/opendatakit/orgs","repos_url":"https://api.github.com/users/opendatakit/repos","events_url":"https://api.github.com/users/opendatakit/events{/privacy}","received_events_url":"https://api.github.com/users/opendatakit/received_events","type":"Organization","site_admin":false},"repo":{"id":92860132,"name":"docs","full_name":"opendatakit/docs","owner":{"login":"opendatakit","id":6222985,"avatar_url":"https://avatars0.githubusercontent.com/u/6222985?v=4","gravatar_id":"","url":"https://api.github.com/users/opendatakit","html_url":"https://github.com/opendatakit","followers_url":"https://api.github.com/users/opendatakit/followers","following_url":"https://api.github.com/users/opendatakit/following{/other_user}","gists_url":"https://api.github.com/users/opendatakit/gists{/gist_id}","starred_url":"https://api.github.com/users/opendatakit/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/opendatakit/subscriptions","organizations_url":"https://api.github.com/users/opendatakit/orgs","repos_url":"https://api.github.com/users/opendatakit/repos","events_url":"https://api.github.com/users/opendatakit/events{/privacy}","received_events_url":"https://api.github.com/users/opendatakit/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/opendatakit/docs","description":"Open Data Kit Documentation, built in Sphinx.","fork":false,"url":"https://api.github.com/repos/opendatakit/docs","forks_url":"https://api.github.com/repos/opendatakit/docs/forks","keys_url":"https://api.github.com/repos/opendatakit/docs/keys{/key_id}","collaborators_url":"https://api.github.com/repos/opendatakit/docs/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/opendatakit/docs/teams","hooks_url":"https://api.github.com/repos/opendatakit/docs/hooks","issue_events_url":"https://api.github.com/repos/opendatakit/docs/issues/events{/number}","events_url":"https://api.github.com/repos/opendatakit/docs/events","assignees_url":"https://api.github.com/repos/opendatakit/docs/assignees{/user}","branches_url":"https://api.github.com/repos/opendatakit/docs/branches{/branch}","tags_url":"https://api.github.com/repos/opendatakit/docs/tags","blobs_url":"https://api.github.com/repos/opendatakit/docs/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/opendatakit/docs/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/opendatakit/docs/git/refs{/sha}","trees_url":"https://api.github.com/repos/opendatakit/docs/git/trees{/sha}","statuses_url":"https://api.github.com/repos/opendatakit/docs/statuses/{sha}","languages_url":"https://api.github.com/repos/opendatakit/docs/languages","stargazers_url":"https://api.github.com/repos/opendatakit/docs/stargazers","contributors_url":"https://api.github.com/repos/opendatakit/docs/contributors","subscribers_url":"https://api.github.com/repos/opendatakit/docs/subscribers","subscription_url":"https://api.github.com/repos/opendatakit/docs/subscription","commits_url":"https://api.github.com/repos/opendatakit/docs/commits{/sha}","git_commits_url":"https://api.github.com/repos/opendatakit/docs/git/commits{/sha}","comments_url":"https://api.github.com/repos/opendatakit/docs/comments{/number}","issue_comment_url":"https://api.github.com/repos/opendatakit/docs/issues/comments{/number}","contents_url":"https://api.github.com/repos/opendatakit/docs/contents/{+path}","compare_url":"https://api.github.com/repos/opendatakit/docs/compare/{base}...{head}","merges_url":"https://api.github.com/repos/opendatakit/docs/merges","archive_url":"https://api.github.com/repos/opendatakit/docs/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/opendatakit/docs/downloads","issues_url":"https://api.github.com/repos/opendatakit/docs/issues{/number}","pulls_url":"https://api.github.com/repos/opendatakit/docs/pulls{/number}","milestones_url":"https://api.github.com/repos/opendatakit/docs/milestones{/number}","notifications_url":"https://api.github.com/repos/opendatakit/docs/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/opendatakit/docs/labels{/name}","releases_url":"https://api.github.com/repos/opendatakit/docs/releases{/id}","deployments_url":"https://api.github.com/repos/opendatakit/docs/deployments","created_at":"2017-05-30T17:45:43Z","updated_at":"2018-04-07T14:28:15Z","pushed_at":"2018-04-07T14:28:13Z","git_url":"git://github.com/opendatakit/docs.git","ssh_url":"git@github.com:opendatakit/docs.git","clone_url":"https://github.com/opendatakit/docs.git","svn_url":"https://github.com/opendatakit/docs","homepage":"http://docs.opendatakit.org/","size":1377,"stargazers_count":12,"watchers_count":12,"language":"Python","has_issues":true,"has_projects":true,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":59,"mirror_url":null,"archived":false,"open_issues_count":118,"license":{"key":"other","name":"Other","spdx_id":null,"url":null},"forks":59,"open_issues":118,"watchers":12,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/633"},"html":{"href":"https://github.com/opendatakit/docs/pull/633"},"issue":{"href":"https://api.github.com/repos/opendatakit/docs/issues/633"},"comments":{"href":"https://api.github.com/repos/opendatakit/docs/issues/633/comments"},"review_comments":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/633/comments"},"review_comment":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/opendatakit/docs/pulls/633/commits"},"statuses":{"href":"https://api.github.com/repos/opendatakit/docs/statuses/178d00a63c884831460bd19b7aba4ac77db4c42e"}},"author_association":"COLLABORATOR"}}
{"actor":{"display_login":"linl33"}}