{"action":"created","comment":{"url":"https://api.github.com/repos/django/django/pulls/comments/30474668","id":30474668,"diff_hunk":"@@ -86,11 +87,39 @@ the respective field according to your needs.\n * Add the field on your model with ``default=...`` and ``unique=True``\n   arguments. In the example, we use ``uuid.uuid4`` for the default.\n \n-* Run the :djadmin:`makemigrations` command.\n+* Run the :djadmin:`makemigrations` command. This should generate a migration\n+  with an ``AddField`` operation.\n \n-* Edit the created migration file.\n+* Generate two empty migration files for the app by running\n+  ``makemigrations myapp --empty`` twice.\n \n-  The generated migration class should look similar to this::\n+* Copy the ``AddField`` operation from the auto-generated migration (the first\n+  of the three new files) to the last migration and change ``AddField`` to\n+  ``AlterField``. For example::\n+\n+        # -*- coding: utf-8 -*-","path":"docs/howto/writing-migrations.txt","position":25,"original_position":25,"commit_id":"ac353f2ebcdd501535fe229e205955f4cf7058ab","original_commit_id":"ac353f2ebcdd501535fe229e205955f4cf7058ab","user":{"login":"MarkusH","id":475613,"avatar_url":"https://avatars.githubusercontent.com/u/475613?v=3","gravatar_id":"","url":"https://api.github.com/users/MarkusH","html_url":"https://github.com/MarkusH","followers_url":"https://api.github.com/users/MarkusH/followers","following_url":"https://api.github.com/users/MarkusH/following{/other_user}","gists_url":"https://api.github.com/users/MarkusH/gists{/gist_id}","starred_url":"https://api.github.com/users/MarkusH/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/MarkusH/subscriptions","organizations_url":"https://api.github.com/users/MarkusH/orgs","repos_url":"https://api.github.com/users/MarkusH/repos","events_url":"https://api.github.com/users/MarkusH/events{/privacy}","received_events_url":"https://api.github.com/users/MarkusH/received_events","type":"User","site_admin":false},"body":"I think we should use the [`:snippet:`](https://github.com/django/django/blob/master/docs/intro/tutorial01.txt#L350-L351) syntax to show explicit file names for the migrations","created_at":"2015-05-17T20:44:48Z","updated_at":"2015-05-17T20:44:48Z","html_url":"https://github.com/django/django/pull/4650#discussion_r30474668","pull_request_url":"https://api.github.com/repos/django/django/pulls/4650","_links":{"self":{"href":"https://api.github.com/repos/django/django/pulls/comments/30474668"},"html":{"href":"https://github.com/django/django/pull/4650#discussion_r30474668"},"pull_request":{"href":"https://api.github.com/repos/django/django/pulls/4650"}}},"pull_request":{"url":"https://api.github.com/repos/django/django/pulls/4650","id":35320920,"html_url":"https://github.com/django/django/pull/4650","diff_url":"https://github.com/django/django/pull/4650.diff","patch_url":"https://github.com/django/django/pull/4650.patch","issue_url":"https://api.github.com/repos/django/django/issues/4650","number":4650,"state":"open","locked":false,"title":"Fixed #24630 -- Clarified docs about RunPython transactions.","user":{"login":"timgraham","id":411869,"avatar_url":"https://avatars.githubusercontent.com/u/411869?v=3","gravatar_id":"","url":"https://api.github.com/users/timgraham","html_url":"https://github.com/timgraham","followers_url":"https://api.github.com/users/timgraham/followers","following_url":"https://api.github.com/users/timgraham/following{/other_user}","gists_url":"https://api.github.com/users/timgraham/gists{/gist_id}","starred_url":"https://api.github.com/users/timgraham/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgraham/subscriptions","organizations_url":"https://api.github.com/users/timgraham/orgs","repos_url":"https://api.github.com/users/timgraham/repos","events_url":"https://api.github.com/users/timgraham/events{/privacy}","received_events_url":"https://api.github.com/users/timgraham/received_events","type":"User","site_admin":false},"body":"","created_at":"2015-05-13T12:24:16Z","updated_at":"2015-05-17T20:44:48Z","closed_at":null,"merged_at":null,"merge_commit_sha":"33a6ce2b3c52142f085998b0d57d8f9a7d90ebcc","assignee":null,"milestone":null,"commits_url":"https://api.github.com/repos/django/django/pulls/4650/commits","review_comments_url":"https://api.github.com/repos/django/django/pulls/4650/comments","review_comment_url":"https://api.github.com/repos/django/django/pulls/comments{/number}","comments_url":"https://api.github.com/repos/django/django/issues/4650/comments","statuses_url":"https://api.github.com/repos/django/django/statuses/ac353f2ebcdd501535fe229e205955f4cf7058ab","head":{"label":"timgraham:24630","ref":"24630","sha":"ac353f2ebcdd501535fe229e205955f4cf7058ab","user":{"login":"timgraham","id":411869,"avatar_url":"https://avatars.githubusercontent.com/u/411869?v=3","gravatar_id":"","url":"https://api.github.com/users/timgraham","html_url":"https://github.com/timgraham","followers_url":"https://api.github.com/users/timgraham/followers","following_url":"https://api.github.com/users/timgraham/following{/other_user}","gists_url":"https://api.github.com/users/timgraham/gists{/gist_id}","starred_url":"https://api.github.com/users/timgraham/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgraham/subscriptions","organizations_url":"https://api.github.com/users/timgraham/orgs","repos_url":"https://api.github.com/users/timgraham/repos","events_url":"https://api.github.com/users/timgraham/events{/privacy}","received_events_url":"https://api.github.com/users/timgraham/received_events","type":"User","site_admin":false},"repo":{"id":6815085,"name":"django","full_name":"timgraham/django","owner":{"login":"timgraham","id":411869,"avatar_url":"https://avatars.githubusercontent.com/u/411869?v=3","gravatar_id":"","url":"https://api.github.com/users/timgraham","html_url":"https://github.com/timgraham","followers_url":"https://api.github.com/users/timgraham/followers","following_url":"https://api.github.com/users/timgraham/following{/other_user}","gists_url":"https://api.github.com/users/timgraham/gists{/gist_id}","starred_url":"https://api.github.com/users/timgraham/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/timgraham/subscriptions","organizations_url":"https://api.github.com/users/timgraham/orgs","repos_url":"https://api.github.com/users/timgraham/repos","events_url":"https://api.github.com/users/timgraham/events{/privacy}","received_events_url":"https://api.github.com/users/timgraham/received_events","type":"User","site_admin":false},"private":false,"html_url":"https://github.com/timgraham/django","description":"The Web framework for perfectionists with deadlines.","fork":true,"url":"https://api.github.com/repos/timgraham/django","forks_url":"https://api.github.com/repos/timgraham/django/forks","keys_url":"https://api.github.com/repos/timgraham/django/keys{/key_id}","collaborators_url":"https://api.github.com/repos/timgraham/django/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/timgraham/django/teams","hooks_url":"https://api.github.com/repos/timgraham/django/hooks","issue_events_url":"https://api.github.com/repos/timgraham/django/issues/events{/number}","events_url":"https://api.github.com/repos/timgraham/django/events","assignees_url":"https://api.github.com/repos/timgraham/django/assignees{/user}","branches_url":"https://api.github.com/repos/timgraham/django/branches{/branch}","tags_url":"https://api.github.com/repos/timgraham/django/tags","blobs_url":"https://api.github.com/repos/timgraham/django/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/timgraham/django/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/timgraham/django/git/refs{/sha}","trees_url":"https://api.github.com/repos/timgraham/django/git/trees{/sha}","statuses_url":"https://api.github.com/repos/timgraham/django/statuses/{sha}","languages_url":"https://api.github.com/repos/timgraham/django/languages","stargazers_url":"https://api.github.com/repos/timgraham/django/stargazers","contributors_url":"https://api.github.com/repos/timgraham/django/contributors","subscribers_url":"https://api.github.com/repos/timgraham/django/subscribers","subscription_url":"https://api.github.com/repos/timgraham/django/subscription","commits_url":"https://api.github.com/repos/timgraham/django/commits{/sha}","git_commits_url":"https://api.github.com/repos/timgraham/django/git/commits{/sha}","comments_url":"https://api.github.com/repos/timgraham/django/comments{/number}","issue_comment_url":"https://api.github.com/repos/timgraham/django/issues/comments{/number}","contents_url":"https://api.github.com/repos/timgraham/django/contents/{+path}","compare_url":"https://api.github.com/repos/timgraham/django/compare/{base}...{head}","merges_url":"https://api.github.com/repos/timgraham/django/merges","archive_url":"https://api.github.com/repos/timgraham/django/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/timgraham/django/downloads","issues_url":"https://api.github.com/repos/timgraham/django/issues{/number}","pulls_url":"https://api.github.com/repos/timgraham/django/pulls{/number}","milestones_url":"https://api.github.com/repos/timgraham/django/milestones{/number}","notifications_url":"https://api.github.com/repos/timgraham/django/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/timgraham/django/labels{/name}","releases_url":"https://api.github.com/repos/timgraham/django/releases{/id}","created_at":"2012-11-22T15:27:43Z","updated_at":"2015-05-01T14:47:45Z","pushed_at":"2015-05-17T20:26:16Z","git_url":"git://github.com/timgraham/django.git","ssh_url":"git@github.com:timgraham/django.git","clone_url":"https://github.com/timgraham/django.git","svn_url":"https://github.com/timgraham/django","homepage":"http://www.djangoproject.com/","size":113718,"stargazers_count":0,"watchers_count":0,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":1,"mirror_url":null,"open_issues_count":0,"forks":1,"open_issues":0,"watchers":0,"default_branch":"master"}},"base":{"label":"django:master","ref":"master","sha":"0eaef8e527af556c0c517a64035929404cf94a39","user":{"login":"django","id":27804,"avatar_url":"https://avatars.githubusercontent.com/u/27804?v=3","gravatar_id":"","url":"https://api.github.com/users/django","html_url":"https://github.com/django","followers_url":"https://api.github.com/users/django/followers","following_url":"https://api.github.com/users/django/following{/other_user}","gists_url":"https://api.github.com/users/django/gists{/gist_id}","starred_url":"https://api.github.com/users/django/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/django/subscriptions","organizations_url":"https://api.github.com/users/django/orgs","repos_url":"https://api.github.com/users/django/repos","events_url":"https://api.github.com/users/django/events{/privacy}","received_events_url":"https://api.github.com/users/django/received_events","type":"Organization","site_admin":false},"repo":{"id":4164482,"name":"django","full_name":"django/django","owner":{"login":"django","id":27804,"avatar_url":"https://avatars.githubusercontent.com/u/27804?v=3","gravatar_id":"","url":"https://api.github.com/users/django","html_url":"https://github.com/django","followers_url":"https://api.github.com/users/django/followers","following_url":"https://api.github.com/users/django/following{/other_user}","gists_url":"https://api.github.com/users/django/gists{/gist_id}","starred_url":"https://api.github.com/users/django/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/django/subscriptions","organizations_url":"https://api.github.com/users/django/orgs","repos_url":"https://api.github.com/users/django/repos","events_url":"https://api.github.com/users/django/events{/privacy}","received_events_url":"https://api.github.com/users/django/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/django/django","description":"The Web framework for perfectionists with deadlines.","fork":false,"url":"https://api.github.com/repos/django/django","forks_url":"https://api.github.com/repos/django/django/forks","keys_url":"https://api.github.com/repos/django/django/keys{/key_id}","collaborators_url":"https://api.github.com/repos/django/django/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/django/django/teams","hooks_url":"https://api.github.com/repos/django/django/hooks","issue_events_url":"https://api.github.com/repos/django/django/issues/events{/number}","events_url":"https://api.github.com/repos/django/django/events","assignees_url":"https://api.github.com/repos/django/django/assignees{/user}","branches_url":"https://api.github.com/repos/django/django/branches{/branch}","tags_url":"https://api.github.com/repos/django/django/tags","blobs_url":"https://api.github.com/repos/django/django/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/django/django/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/django/django/git/refs{/sha}","trees_url":"https://api.github.com/repos/django/django/git/trees{/sha}","statuses_url":"https://api.github.com/repos/django/django/statuses/{sha}","languages_url":"https://api.github.com/repos/django/django/languages","stargazers_url":"https://api.github.com/repos/django/django/stargazers","contributors_url":"https://api.github.com/repos/django/django/contributors","subscribers_url":"https://api.github.com/repos/django/django/subscribers","subscription_url":"https://api.github.com/repos/django/django/subscription","commits_url":"https://api.github.com/repos/django/django/commits{/sha}","git_commits_url":"https://api.github.com/repos/django/django/git/commits{/sha}","comments_url":"https://api.github.com/repos/django/django/comments{/number}","issue_comment_url":"https://api.github.com/repos/django/django/issues/comments{/number}","contents_url":"https://api.github.com/repos/django/django/contents/{+path}","compare_url":"https://api.github.com/repos/django/django/compare/{base}...{head}","merges_url":"https://api.github.com/repos/django/django/merges","archive_url":"https://api.github.com/repos/django/django/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/django/django/downloads","issues_url":"https://api.github.com/repos/django/django/issues{/number}","pulls_url":"https://api.github.com/repos/django/django/pulls{/number}","milestones_url":"https://api.github.com/repos/django/django/milestones{/number}","notifications_url":"https://api.github.com/repos/django/django/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/django/django/labels{/name}","releases_url":"https://api.github.com/repos/django/django/releases{/id}","created_at":"2012-04-28T02:47:18Z","updated_at":"2015-05-17T19:45:17Z","pushed_at":"2015-05-17T20:27:29Z","git_url":"git://github.com/django/django.git","ssh_url":"git@github.com:django/django.git","clone_url":"https://github.com/django/django.git","svn_url":"https://github.com/django/django","homepage":"https://www.djangoproject.com/","size":296305,"stargazers_count":14260,"watchers_count":14260,"language":"Python","has_issues":false,"has_downloads":true,"has_wiki":false,"has_pages":false,"forks_count":5668,"mirror_url":null,"open_issues_count":76,"forks":5668,"open_issues":76,"watchers":14260,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/django/django/pulls/4650"},"html":{"href":"https://github.com/django/django/pull/4650"},"issue":{"href":"https://api.github.com/repos/django/django/issues/4650"},"comments":{"href":"https://api.github.com/repos/django/django/issues/4650/comments"},"review_comments":{"href":"https://api.github.com/repos/django/django/pulls/4650/comments"},"review_comment":{"href":"https://api.github.com/repos/django/django/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/django/django/pulls/4650/commits"},"statuses":{"href":"https://api.github.com/repos/django/django/statuses/ac353f2ebcdd501535fe229e205955f4cf7058ab"}}}}