{"action":"created","comment":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/80417712","id":80417712,"diff_hunk":"@@ -0,0 +1,94 @@\n+.. _Compiling a Theme:\n+\n+#######################\n+Compiling a Theme\n+#######################\n+\n+To update a theme, you compile the Sass files to create the CSS files that\n+style your UI when you apply the theme.\n+\n+.. contents::\n+   :local:\n+   :depth: 1\n+\n+*************************************\n+Update a Theme for the LMS or Studio\n+*************************************\n+\n+To update a theme for Studio or the LMS, follow these steps.\n+\n+#. Log in to the Open edX machine as the ``edxapp`` user.\n+\n+#. Change to the ``/edx/app/edxapp/edx-platform`` directory.\n+\n+#. Execute the ``paver update_assets`` command to update and apply all themes.\n+\n+   If you want to update specific themes, use the options described in the\n+   following table.\n+\n+   .. list-table::\n+    :header-rows: 1\n+    :widths: 30 70\n+\n+    * - Option\n+      - Description\n+    * - ``--theme-dirs``\n+      - Provide a space-separated list of the theme directories that you want\n+        to update. Only files in the theme directories that you include\n+        are updated.\n+    * - ``--themes``\n+      - Provide a space-separated list of the themes that you want to update.\n+        Only the themes that you include are updated.\n+\n+******************************************\n+Update a Theme for the E-commerce Service\n+******************************************\n+\n+For the E-commerce service, commands are available for you to update and apply\n+all themes at once, or to update only the themes you specify.\n+\n+To update a theme for the E-commerce service, follow these steps.\n+\n+#. Log in to the server for the E-commerce service as the ``ecommerce`` user.\n+\n+#. Change to the ``/edx/app/ecommerce/ecommerce`` directory.\n+\n+#. To update and apply all themes, execute one of these commands.\n+\n+   * ``make migrate``\n+\n+   * ``python manage.py update_assets``\n+\n+#. To specify a theme or set of themes to update, or other optional settings,\n+   execute the ``python manage.py update_assets`` with the options described\n+   in the following table.\n+\n+   .. list-table::\n+    :header-rows: 1\n+    :widths: 30 70\n+\n+    * - Option\n+      - Description\n+    * - ``--settings``\n+      - Supply the database ID of the site for which you want to update themes.","path":"en_us/install_operations/source/configuration/changing_appearance/theming/compiling_theme.rst","position":73,"original_position":73,"commit_id":"c24d8db8d4df212ea40f02acee317cfd0c9b7ffe","original_commit_id":"c24d8db8d4df212ea40f02acee317cfd0c9b7ffe","user":{"login":"saleem-latif","id":7114956,"avatar_url":"https://avatars.githubusercontent.com/u/7114956?v=3","gravatar_id":"","url":"https://api.github.com/users/saleem-latif","html_url":"https://github.com/saleem-latif","followers_url":"https://api.github.com/users/saleem-latif/followers","following_url":"https://api.github.com/users/saleem-latif/following{/other_user}","gists_url":"https://api.github.com/users/saleem-latif/gists{/gist_id}","starred_url":"https://api.github.com/users/saleem-latif/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/saleem-latif/subscriptions","organizations_url":"https://api.github.com/users/saleem-latif/orgs","repos_url":"https://api.github.com/users/saleem-latif/repos","events_url":"https://api.github.com/users/saleem-latif/events{/privacy}","received_events_url":"https://api.github.com/users/saleem-latif/received_events","type":"User","site_admin":false},"body":"`--settings` argument is used to specify settings file to use for running a particular management command. This is a django related argument and is passed as is to django system.\r\nDescription could be something like this\r\n\r\n> Supply the settings module to use. The settings module should be in Python package syntax, e.g. `ecommerce.settings.production `\r\n\r\nref: https://docs.djangoproject.com/en/1.10/ref/django-admin/#cmdoption--settings\r\n\r\n\r\n\r\n","created_at":"2016-09-26T07:10:02Z","updated_at":"2016-09-26T07:10:02Z","html_url":"https://github.com/edx/edx-documentation/pull/1243#discussion_r80417712","pull_request_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1243","_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments/80417712"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1243#discussion_r80417712"},"pull_request":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1243"}}},"pull_request":{"url":"https://api.github.com/repos/edx/edx-documentation/pulls/1243","id":85418807,"html_url":"https://github.com/edx/edx-documentation/pull/1243","diff_url":"https://github.com/edx/edx-documentation/pull/1243.diff","patch_url":"https://github.com/edx/edx-documentation/pull/1243.patch","issue_url":"https://api.github.com/repos/edx/edx-documentation/issues/1243","number":1243,"state":"open","locked":false,"title":"Replaces theming doc with a new version, including sites","user":{"login":"lamagnifica","id":6392274,"avatar_url":"https://avatars.githubusercontent.com/u/6392274?v=3","gravatar_id":"","url":"https://api.github.com/users/lamagnifica","html_url":"https://github.com/lamagnifica","followers_url":"https://api.github.com/users/lamagnifica/followers","following_url":"https://api.github.com/users/lamagnifica/following{/other_user}","gists_url":"https://api.github.com/users/lamagnifica/gists{/gist_id}","starred_url":"https://api.github.com/users/lamagnifica/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/lamagnifica/subscriptions","organizations_url":"https://api.github.com/users/lamagnifica/orgs","repos_url":"https://api.github.com/users/lamagnifica/repos","events_url":"https://api.github.com/users/lamagnifica/events{/privacy}","received_events_url":"https://api.github.com/users/lamagnifica/received_events","type":"User","site_admin":false},"body":"## [DOC-2636](https://openedx.atlassian.net/browse/DOC-2636)\r\n\r\nReviewers, this is Peter's work, which I have taken over. I did a developmental edit and added some questions based on my own lack of background.\r\n\r\n### Date Needed \r\n\r\nI'd like to get this out, and begin building on it with other references that the community needs, as soon as possible.\r\n\r\n### Reviewers\r\n\r\nPossible roles follow. The PR submitter checks the boxes after each reviewer finishes and gives :+1:. \r\n\r\n- [ ] Subject matter expert: @mattdrayer \r\n- [ ] Subject matter expert: @douglashall \r\n- [ ] Subject matter expert: @saleem-latif \r\n- [ ] Subject matter expert: @andy-armstrong \r\n- [ ] Doc team review (sanity check): @edx/doc\r\n- [ ] Product review:\r\n- [ ] Partner support: \r\n- [ ] PM review: \r\n\r\nFYI: @nedbat @scottrish \r\n\r\n### Testing\r\n\r\n- [ ] Ran ./run_tests.sh without warnings or errors\r\n\r\n### Post-review\r\n\r\n- [ ] Add a comment with the description of this change or link this PR to the next release notes task.\r\n- [ ] Squash commits\r\n\r\n","created_at":"2016-09-15T14:49:14Z","updated_at":"2016-09-26T07:33:26Z","closed_at":null,"merged_at":null,"merge_commit_sha":"a9cdd565afabf2c84f63fa5ceb32cc0e5a9be051","assignee":null,"assignees":[],"milestone":null,"commits_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1243/commits","review_comments_url":"https://api.github.com/repos/edx/edx-documentation/pulls/1243/comments","review_comment_url":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}","comments_url":"https://api.github.com/repos/edx/edx-documentation/issues/1243/comments","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/c24d8db8d4df212ea40f02acee317cfd0c9b7ffe","head":{"label":"edx:pdesjardins/DOC-2636","ref":"pdesjardins/DOC-2636","sha":"c24d8db8d4df212ea40f02acee317cfd0c9b7ffe","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-09-23T15:54:47Z","pushed_at":"2016-09-26T06:07:32Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":112044,"stargazers_count":49,"watchers_count":49,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":148,"mirror_url":null,"open_issues_count":19,"forks":148,"open_issues":19,"watchers":49,"default_branch":"master"}},"base":{"label":"edx:master","ref":"master","sha":"3ecba9233173e083069dd6d9226bdf4248e48120","user":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"repo":{"id":23839256,"name":"edx-documentation","full_name":"edx/edx-documentation","owner":{"login":"edx","id":3179841,"avatar_url":"https://avatars.githubusercontent.com/u/3179841?v=3","gravatar_id":"","url":"https://api.github.com/users/edx","html_url":"https://github.com/edx","followers_url":"https://api.github.com/users/edx/followers","following_url":"https://api.github.com/users/edx/following{/other_user}","gists_url":"https://api.github.com/users/edx/gists{/gist_id}","starred_url":"https://api.github.com/users/edx/starred{/owner}{/repo}","subscriptions_url":"https://api.github.com/users/edx/subscriptions","organizations_url":"https://api.github.com/users/edx/orgs","repos_url":"https://api.github.com/users/edx/repos","events_url":"https://api.github.com/users/edx/events{/privacy}","received_events_url":"https://api.github.com/users/edx/received_events","type":"Organization","site_admin":false},"private":false,"html_url":"https://github.com/edx/edx-documentation","description":"For published versions of the edX documentation, visit:","fork":false,"url":"https://api.github.com/repos/edx/edx-documentation","forks_url":"https://api.github.com/repos/edx/edx-documentation/forks","keys_url":"https://api.github.com/repos/edx/edx-documentation/keys{/key_id}","collaborators_url":"https://api.github.com/repos/edx/edx-documentation/collaborators{/collaborator}","teams_url":"https://api.github.com/repos/edx/edx-documentation/teams","hooks_url":"https://api.github.com/repos/edx/edx-documentation/hooks","issue_events_url":"https://api.github.com/repos/edx/edx-documentation/issues/events{/number}","events_url":"https://api.github.com/repos/edx/edx-documentation/events","assignees_url":"https://api.github.com/repos/edx/edx-documentation/assignees{/user}","branches_url":"https://api.github.com/repos/edx/edx-documentation/branches{/branch}","tags_url":"https://api.github.com/repos/edx/edx-documentation/tags","blobs_url":"https://api.github.com/repos/edx/edx-documentation/git/blobs{/sha}","git_tags_url":"https://api.github.com/repos/edx/edx-documentation/git/tags{/sha}","git_refs_url":"https://api.github.com/repos/edx/edx-documentation/git/refs{/sha}","trees_url":"https://api.github.com/repos/edx/edx-documentation/git/trees{/sha}","statuses_url":"https://api.github.com/repos/edx/edx-documentation/statuses/{sha}","languages_url":"https://api.github.com/repos/edx/edx-documentation/languages","stargazers_url":"https://api.github.com/repos/edx/edx-documentation/stargazers","contributors_url":"https://api.github.com/repos/edx/edx-documentation/contributors","subscribers_url":"https://api.github.com/repos/edx/edx-documentation/subscribers","subscription_url":"https://api.github.com/repos/edx/edx-documentation/subscription","commits_url":"https://api.github.com/repos/edx/edx-documentation/commits{/sha}","git_commits_url":"https://api.github.com/repos/edx/edx-documentation/git/commits{/sha}","comments_url":"https://api.github.com/repos/edx/edx-documentation/comments{/number}","issue_comment_url":"https://api.github.com/repos/edx/edx-documentation/issues/comments{/number}","contents_url":"https://api.github.com/repos/edx/edx-documentation/contents/{+path}","compare_url":"https://api.github.com/repos/edx/edx-documentation/compare/{base}...{head}","merges_url":"https://api.github.com/repos/edx/edx-documentation/merges","archive_url":"https://api.github.com/repos/edx/edx-documentation/{archive_format}{/ref}","downloads_url":"https://api.github.com/repos/edx/edx-documentation/downloads","issues_url":"https://api.github.com/repos/edx/edx-documentation/issues{/number}","pulls_url":"https://api.github.com/repos/edx/edx-documentation/pulls{/number}","milestones_url":"https://api.github.com/repos/edx/edx-documentation/milestones{/number}","notifications_url":"https://api.github.com/repos/edx/edx-documentation/notifications{?since,all,participating}","labels_url":"https://api.github.com/repos/edx/edx-documentation/labels{/name}","releases_url":"https://api.github.com/repos/edx/edx-documentation/releases{/id}","deployments_url":"https://api.github.com/repos/edx/edx-documentation/deployments","created_at":"2014-09-09T15:29:04Z","updated_at":"2016-09-23T15:54:47Z","pushed_at":"2016-09-26T06:07:32Z","git_url":"git://github.com/edx/edx-documentation.git","ssh_url":"git@github.com:edx/edx-documentation.git","clone_url":"https://github.com/edx/edx-documentation.git","svn_url":"https://github.com/edx/edx-documentation","homepage":" http://docs.edx.org","size":112044,"stargazers_count":49,"watchers_count":49,"language":"Makefile","has_issues":true,"has_downloads":true,"has_wiki":false,"has_pages":true,"forks_count":148,"mirror_url":null,"open_issues_count":19,"forks":148,"open_issues":19,"watchers":49,"default_branch":"master"}},"_links":{"self":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1243"},"html":{"href":"https://github.com/edx/edx-documentation/pull/1243"},"issue":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1243"},"comments":{"href":"https://api.github.com/repos/edx/edx-documentation/issues/1243/comments"},"review_comments":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1243/comments"},"review_comment":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/comments{/number}"},"commits":{"href":"https://api.github.com/repos/edx/edx-documentation/pulls/1243/commits"},"statuses":{"href":"https://api.github.com/repos/edx/edx-documentation/statuses/c24d8db8d4df212ea40f02acee317cfd0c9b7ffe"}}}}
{"actor":{"display_login":"saleem-latif"}}