)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"92cad8af1d1793f33d986949e3283a657d5b4e1b","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Commit:     Shaunak Kashyap \u003cshaunak.kashyap@rackspace.com\u003e"},{"line_number":5,"context_line":"CommitDate: 2014-05-27 19:11:05 -0700"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Changes per reviews."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Change-Id: I45cb62402812bc1088893dc4de31eca31c8685d0"},{"line_number":10,"context_line":"Implements: blueprint sphinx-docs"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":3,"id":"3ae8d1ca_d4b8b9e7","line":7,"updated":"2014-05-28 18:51:24.000000000","message":"Can you please update the commit comment to describe what the change does?","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"e83b498ec34147cad1439296bf7e77bc56360982","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Commit:     Shaunak Kashyap \u003cshaunak.kashyap@rackspace.com\u003e"},{"line_number":5,"context_line":"CommitDate: 2014-05-27 19:11:05 -0700"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"Changes per reviews."},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Change-Id: I45cb62402812bc1088893dc4de31eca31c8685d0"},{"line_number":10,"context_line":"Implements: blueprint sphinx-docs"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":3,"id":"1ae5cdf2_1cc08c7b","line":7,"in_reply_to":"3ae8d1ca_d4b8b9e7","updated":"2014-06-01 23:49:20.000000000","message":"Sorry about that. I\u0027ve used a more descriptive commit message for the next patch (#4). I\u0027m not sure how to update the commit message of this patch (#3).","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"}],"CONTRIBUTING.rst":[{"author":{"_account_id":10517,"name":"Jamie Hannaford","email":"jamie.hannaford@rackspace.com","username":"jamiehannaford"},"change_message_id":"870ee50ea08f61f8348e70a53c6be2a79d6983e9","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following:"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. code:: bash"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_bb7cb5b6","line":16,"updated":"2014-05-06 09:01:24.000000000","message":"Considering this won\u0027t have been parsed by the Sphinx interpreter, I\u0027m not sure how this will appear if a user is reading this on Github - I don\u0027t think code blocks are rendered.\n\nOther projects like Keystone and Nova have top-level RST files with bash prompts by doing this (note the trailing double-colon and indentation):\n\nLorem ipsum blah::\n\n   sphinx-build etc.","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"73a6d633e40eada6c60e10f013f80d24d97f4d79","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following:"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. code:: bash"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_f90720c8","line":16,"in_reply_to":"9ad9bd40_bb7cb5b6","updated":"2014-05-06 13:09:29.000000000","message":"Yes, duh. Good catch. Fixing.","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"86b793ce83ff948cbbaa54f93e51340fecbc7066","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following:"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":".. code:: bash"},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":19,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_b99118f3","line":16,"in_reply_to":"9ad9bd40_f90720c8","updated":"2014-06-01 23:50:27.000000000","message":"Done","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":9700,"name":"Sam Choi","email":"sam.choi@hp.com","username":"samuelchoi"},"change_message_id":"9ec2461bde209753cebdd4fc0eb0908d721150cf","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following::"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This will generate a HTML user guide whose entry point will be `build/html/user-guides/index.html`."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7adec928_7f02793f","line":16,"updated":"2014-05-09 05:55:37.000000000","message":"I\u0027ve taken some time to read up on Sphinx while going through this review. I\u0027m currently reviewing and built the docs on an Ubuntu 12.04 VM. I skimmed the Sphinx intro docs but didn\u0027t find everything I needed so a few questions/concerns:\n\n1. Are we assuming that contributors/users of the API have knowledge of Sphinx? I understand that it\u0027s used in OpenStack but haven\u0027t seen it in many PHP projects yet so I hope we\u0027re assuming that the user has no knowledge of Sphinx.\n\n2. I feel like it would be worth it to put a quick blurb on how to access the HTML pages that were just generated. I used to work in web development so my first instinct was to do a pwd on the docs folder and then enter \u0027home/sam/Coding/openstackPHP/openstack-sdk-php/build/html/user-guides/\u0027 into my browser to bring up the files. Or is there a better way? It may be common sense for some users or become a stumbling block for others.\n\n3. I assume the \u0027sphinx-build\u0027 command would be fine on Linux since Python  comes with base installs. How would this work on a Windows machine? If I understand Sphinx correctly, should we instruct Windows users to download Python first?","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":9700,"name":"Sam Choi","email":"sam.choi@hp.com","username":"samuelchoi"},"change_message_id":"915c62cf26e467667397b8c704bee6f305fba0dc","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following::"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This will generate a HTML user guide whose entry point will be `build/html/user-guides/index.html`."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7adec928_830d0041","line":16,"in_reply_to":"7adec928_2c227401","updated":"2014-05-13 08:55:08.000000000","message":"I\u0027m not sure what OS everyone is using at the moment, but I don\u0027t feel like it\u0027d be prudent to ignore such a dominant OS if we\u0027re aiming to have widespread adoption of the SDK. But then again, we\u0027ve never discussed OS\u0027s to cater to so maybe anything Windows related can be part of another review/patch.\n\n I\u0027m also interested in hearing back from Matt and others at the OpenStack summit, but if we continue in the same direction with the docs, I have a Win7 machine available and can add instructions. I\u0027m also wondering - what is the long term plan for docs? Will every user be expected to have Python and generate docs on their own or would this be published and readily available online?","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"c0860a48d30148a3d5987827ba8087840d3ba418","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following::"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This will generate a HTML user guide whose entry point will be `build/html/user-guides/index.html`."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7adec928_2c227401","line":16,"in_reply_to":"7adec928_7f02793f","updated":"2014-05-10 20:42:13.000000000","message":"#1 and #2 are solid points. I will add more detail here to address both.\n\nAs for #3, do we currently have any Windows-based contributors? If so, I\u0027d love their help on porting these instructions (after I\u0027ve addressed #1 and #2) to Windows. If not, I\u0027ll take it on myself by spinning up a Windows VM or something. So -- anyone amongst us using Windows right now and want to help with #3?","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"599b56bf8082ec44a83bbec412675038f4e89339","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following::"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This will generate a HTML user guide whose entry point will be `build/html/user-guides/index.html`."}],"source_content_type":"text/x-rst","patch_set":2,"id":"7adec928_a3bd836a","line":16,"in_reply_to":"7adec928_830d0041","updated":"2014-05-14 18:42:10.000000000","message":"I do have a few thoughts and questions...\n\n1. Why would someone want to build the documentation? I see the use case of testing it before it\u0027s deployed to a site (somewhere on developer.openstack.org). Is there another reason?\n\n2. I don\u0027t know of any Windows based developers right now. I\u0027m not aware of many in the OpenStack community. But, I do know that there a Windows based users of our PHP SDK and of OpenStack. I\u0027d like things to be friendly for them. It might be worth linking off to the sphinx install page. That would be useful for Linux, Mac, and Windows. From there a Windows users could learn to install python, right?\n\n3. Aside from documentation, this file needs additions. I don\u0027t think that needs to be part of this change.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"bda9106229692d2244532f36b77a0d8d66afc12a","unresolved":false,"context_lines":[{"line_number":13,"context_line":"From the project\u0027s base directory (which is the same directory that contains this"},{"line_number":14,"context_line":"file), run the following::"},{"line_number":15,"context_line":""},{"line_number":16,"context_line":"  $ sphinx-build doc/user-guides build/html/user-guides "},{"line_number":17,"context_line":""},{"line_number":18,"context_line":"This will generate a HTML user guide whose entry point will be `build/html/user-guides/index.html`."}],"source_content_type":"text/x-rst","patch_set":2,"id":"3ae8d1ca_fd113cad","line":16,"in_reply_to":"7adec928_a3bd836a","updated":"2014-05-28 01:12:54.000000000","message":"Sorry about the delay; I\u0027ve been traveling + sick the past couple of weeks.\n\nI\u0027ll add instructions to download and install Sphinx. I think that\u0027s sufficient for now.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":9700,"name":"Sam Choi","email":"sam.choi@hp.com","username":"samuelchoi"},"change_message_id":"20e9d8f052feb1678f27a64778f77b1064837fe5","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatively, to view the generated documentation in a browser"},{"line_number":36,"context_line":"on Mac OS X, you can simply run:"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"  $ open build/html/user-guides/index.html"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ae8d1ca_fc774c00","line":38,"updated":"2014-05-29 07:28:09.000000000","message":"The additions look good. I\u0027m still wondering though, how will a typical end user be expected to access the docs? Are we going to the host the docs somewhere so that we have a user friendly website available?\n\nAlso, since the README is more than likely going to be a new user\u0027s first point of contact, maybe the README would be a good place to have a URL for these online docs (if we go this route)?","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"e83b498ec34147cad1439296bf7e77bc56360982","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatively, to view the generated documentation in a browser"},{"line_number":36,"context_line":"on Mac OS X, you can simply run:"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"  $ open build/html/user-guides/index.html"}],"source_content_type":"text/x-rst","patch_set":3,"id":"1ae5cdf2_7cd19056","line":38,"in_reply_to":"3ae8d1ca_ac6e6f94","updated":"2014-06-01 23:49:20.000000000","message":"Yes, we will be hosting the generated docs somewhere, which is TBD for now. If you read my email dated 4/27 (I know, a long time ago) to openstack-dev@, subject: \"Questions about user-facing documentation\", you\u0027ll see that we decided to punt on the hosting question and focus on generating the docs for now.","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"},{"author":{"_account_id":10517,"name":"Jamie Hannaford","email":"jamie.hannaford@rackspace.com","username":"jamiehannaford"},"change_message_id":"8e2885f7d187bc377e427f854607044afc0e4690","unresolved":false,"context_lines":[{"line_number":35,"context_line":"Alternatively, to view the generated documentation in a browser"},{"line_number":36,"context_line":"on Mac OS X, you can simply run:"},{"line_number":37,"context_line":""},{"line_number":38,"context_line":"  $ open build/html/user-guides/index.html"}],"source_content_type":"text/x-rst","patch_set":3,"id":"3ae8d1ca_ac6e6f94","line":38,"in_reply_to":"3ae8d1ca_fc774c00","updated":"2014-05-29 11:09:21.000000000","message":"Yeah, I think we\u0027ll definitely host these RST docs somewhere. That\u0027s what a lot of OpenStack-affiliated projects seem to do.\n\nThe end-user will also have the option to build the docs locally too (useful for periods of non-Internet connectivity like flights, train journeys, etc.)","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"}],"doc/user-guides/conf.py":[{"author":{"_account_id":10517,"name":"Jamie Hannaford","email":"jamie.hannaford@rackspace.com","username":"jamiehannaford"},"change_message_id":"870ee50ea08f61f8348e70a53c6be2a79d6983e9","unresolved":false,"context_lines":[{"line_number":1,"context_line":"# -*- coding: utf-8 -*-"},{"line_number":2,"context_line":"#"},{"line_number":3,"context_line":"# PHP SDK for OpenStack documentation build configuration file, created by"},{"line_number":4,"context_line":"# sphinx-quickstart on Tue Apr 29 16:43:30 2014."}],"source_content_type":"text/x-python","patch_set":1,"id":"9ad9bd40_36243cae","line":1,"updated":"2014-05-06 09:01:24.000000000","message":"Playing devil\u0027s advocate: do we need to nest everything inside a \"user-guide\" directory? What other forms of documentation will we support?","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"73a6d633e40eada6c60e10f013f80d24d97f4d79","unresolved":false,"context_lines":[{"line_number":1,"context_line":"# -*- coding: utf-8 -*-"},{"line_number":2,"context_line":"#"},{"line_number":3,"context_line":"# PHP SDK for OpenStack documentation build configuration file, created by"},{"line_number":4,"context_line":"# sphinx-quickstart on Tue Apr 29 16:43:30 2014."}],"source_content_type":"text/x-python","patch_set":1,"id":"9ad9bd40_797eb01a","line":1,"in_reply_to":"9ad9bd40_36243cae","updated":"2014-05-06 13:09:29.000000000","message":"This is how I had proposed it in https://wiki.openstack.org/wiki/OpenStack-SDK-PHP/UserFacingDocumentation#Proposed_Directory_Structure. Since I didn\u0027t receive any feedback, I went ahead and implemented it.\n\nI proposed the additional level of nesting for future flexibility. If we decide to add another form of documentation in the future, this directory structure would make that very easy with no changes to existing files.","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10517,"name":"Jamie Hannaford","email":"jamie.hannaford@rackspace.com","username":"jamiehannaford"},"change_message_id":"47e0495bc11dcf6150b138389af4ec1ca55ba737","unresolved":false,"context_lines":[{"line_number":1,"context_line":"# -*- coding: utf-8 -*-"},{"line_number":2,"context_line":"#"},{"line_number":3,"context_line":"# PHP SDK for OpenStack documentation build configuration file, created by"},{"line_number":4,"context_line":"# sphinx-quickstart on Tue Apr 29 16:43:30 2014."}],"source_content_type":"text/x-python","patch_set":1,"id":"9ad9bd40_39fd086f","line":1,"in_reply_to":"9ad9bd40_797eb01a","updated":"2014-05-06 13:13:19.000000000","message":"Okay, SGTM","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"599b56bf8082ec44a83bbec412675038f4e89339","unresolved":false,"context_lines":[{"line_number":43,"context_line":"master_doc \u003d \u0027index\u0027"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"# General information about the project."},{"line_number":46,"context_line":"project \u003d u\u0027PHP SDK for OpenStack\u0027"},{"line_number":47,"context_line":"copyright \u003d u\u0027© 2014, OpenStack Foundation\u0027"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"# The version info for the project you\u0027re documenting, acts as replacement for"}],"source_content_type":"text/x-python","patch_set":2,"id":"7adec928_83a6c751","line":46,"updated":"2014-05-14 18:42:10.000000000","message":"The name listed here is different from the name in the contributing rst file. Shouldn\u0027t we have a consistent name?","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"bda9106229692d2244532f36b77a0d8d66afc12a","unresolved":false,"context_lines":[{"line_number":43,"context_line":"master_doc \u003d \u0027index\u0027"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"# General information about the project."},{"line_number":46,"context_line":"project \u003d u\u0027PHP SDK for OpenStack\u0027"},{"line_number":47,"context_line":"copyright \u003d u\u0027© 2014, OpenStack Foundation\u0027"},{"line_number":48,"context_line":""},{"line_number":49,"context_line":"# The version info for the project you\u0027re documenting, acts as replacement for"}],"source_content_type":"text/x-python","patch_set":2,"id":"3ae8d1ca_9d7918ff","line":46,"in_reply_to":"7adec928_83a6c751","updated":"2014-05-28 01:12:54.000000000","message":"Agreed. Fixing.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"599b56bf8082ec44a83bbec412675038f4e89339","unresolved":false,"context_lines":[{"line_number":176,"context_line":"#html_file_suffix \u003d None"},{"line_number":177,"context_line":""},{"line_number":178,"context_line":"# Output file base name for HTML help builder."},{"line_number":179,"context_line":"htmlhelp_basename \u003d \u0027PHPSDKforOpenStackdoc\u0027"},{"line_number":180,"context_line":""},{"line_number":181,"context_line":""},{"line_number":182,"context_line":"# -- Options for LaTeX output ---------------------------------------------"}],"source_content_type":"text/x-python","patch_set":2,"id":"7adec928_0372b7e4","line":179,"updated":"2014-05-14 18:42:10.000000000","message":"Should this be OpenStack-SDK-PHP to mirror the project name?","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"0ff4c31965a8a93360dd8b2e9c09df2b6b9f61f3","unresolved":false,"context_lines":[{"line_number":176,"context_line":"#html_file_suffix \u003d None"},{"line_number":177,"context_line":""},{"line_number":178,"context_line":"# Output file base name for HTML help builder."},{"line_number":179,"context_line":"htmlhelp_basename \u003d \u0027PHPSDKforOpenStackdoc\u0027"},{"line_number":180,"context_line":""},{"line_number":181,"context_line":""},{"line_number":182,"context_line":"# -- Options for LaTeX output ---------------------------------------------"}],"source_content_type":"text/x-python","patch_set":2,"id":"3ae8d1ca_1db0a88a","line":179,"in_reply_to":"7adec928_0372b7e4","updated":"2014-05-28 01:21:24.000000000","message":"Yes, it should. Fixing.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"599b56bf8082ec44a83bbec412675038f4e89339","unresolved":false,"context_lines":[{"line_number":227,"context_line":"# (source start file, name, description, authors, manual section)."},{"line_number":228,"context_line":"man_pages \u003d ["},{"line_number":229,"context_line":"    (\u0027index\u0027, \u0027phpsdkforopenstack\u0027, u\u0027PHP SDK for OpenStack Documentation\u0027,"},{"line_number":230,"context_line":"     [u\u0027Shaunak Kashyap\u0027], 1)"},{"line_number":231,"context_line":"]"},{"line_number":232,"context_line":""},{"line_number":233,"context_line":"# If true, show URL addresses after external links."}],"source_content_type":"text/x-python","patch_set":2,"id":"7adec928_4373dfe6","line":230,"updated":"2014-05-14 18:42:10.000000000","message":"Should we list each of the authors here? I ask because there was a recent commit to pull out the list of code contributors by Jamie. I\u0027d like to list no one or give credit in all places.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"0ff4c31965a8a93360dd8b2e9c09df2b6b9f61f3","unresolved":false,"context_lines":[{"line_number":227,"context_line":"# (source start file, name, description, authors, manual section)."},{"line_number":228,"context_line":"man_pages \u003d ["},{"line_number":229,"context_line":"    (\u0027index\u0027, \u0027phpsdkforopenstack\u0027, u\u0027PHP SDK for OpenStack Documentation\u0027,"},{"line_number":230,"context_line":"     [u\u0027Shaunak Kashyap\u0027], 1)"},{"line_number":231,"context_line":"]"},{"line_number":232,"context_line":""},{"line_number":233,"context_line":"# If true, show URL addresses after external links."}],"source_content_type":"text/x-python","patch_set":2,"id":"3ae8d1ca_dd5ac082","line":230,"in_reply_to":"7adec928_4373dfe6","updated":"2014-05-28 01:21:24.000000000","message":"No, I think we should remove all the authors from here to be consistent. I think this was populated from questions Sphinx asked me during setup. I\u0027ll manually edit this now and remove my name.","commit_id":"91e1c4d227fcbde737914a35f8ee24204899bb6f"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"92cad8af1d1793f33d986949e3283a657d5b4e1b","unresolved":false,"context_lines":[{"line_number":1,"context_line":"# -*- coding: utf-8 -*-"},{"line_number":2,"context_line":"#"},{"line_number":3,"context_line":"# OpenStack PHP SDK documentation build configuration file, created by"},{"line_number":4,"context_line":"# sphinx-quickstart on Tue Apr 29 16:43:30 2014."},{"line_number":5,"context_line":"#"}],"source_content_type":"text/x-python","patch_set":3,"id":"3ae8d1ca_54ed89ee","line":2,"updated":"2014-05-28 18:51:24.000000000","message":"Since this is a code file, can you please add the appropriate copyright and license headers.","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"e83b498ec34147cad1439296bf7e77bc56360982","unresolved":false,"context_lines":[{"line_number":1,"context_line":"# -*- coding: utf-8 -*-"},{"line_number":2,"context_line":"#"},{"line_number":3,"context_line":"# OpenStack PHP SDK documentation build configuration file, created by"},{"line_number":4,"context_line":"# sphinx-quickstart on Tue Apr 29 16:43:30 2014."},{"line_number":5,"context_line":"#"}],"source_content_type":"text/x-python","patch_set":3,"id":"1ae5cdf2_3cbf08fd","line":2,"in_reply_to":"3ae8d1ca_54ed89ee","updated":"2014-06-01 23:49:20.000000000","message":"Yes, good point. I will add a Rackspace copyright and Apache 2.0 license header per our discussion in the last IRC meeting. Thanks!","commit_id":"0e59618bd0c51484b88d7b5464b55a4b9abfd1cd"},{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"9489d2e893a2d04e124c9bbd3dc3fb6a28cc7557","unresolved":false,"context_lines":[{"line_number":141,"context_line":"# Add any paths that contain custom static files (such as style sheets) here,"},{"line_number":142,"context_line":"# relative to this directory. They are copied after the builtin static files,"},{"line_number":143,"context_line":"# so a file named \"default.css\" will overwrite the builtin \"default.css\"."},{"line_number":144,"context_line":"html_static_path \u003d [\u0027_static\u0027]"},{"line_number":145,"context_line":""},{"line_number":146,"context_line":"# Add any extra paths that contain custom files (such as robots.txt or"},{"line_number":147,"context_line":"# .htaccess) here, relative to this directory. These files are copied"}],"source_content_type":"text/x-python","patch_set":6,"id":"1ae5cdf2_37a7a80c","line":144,"updated":"2014-06-12 19:06:04.000000000","message":"Got the warning..\n\n`WARNING: html_static_path entry u\u0027/home/mfarina/Code/OS/openstack-sdk-php/doc/user-guides/_static\u0027 does not exist`\n\nCan we comment out this line until we have static content?","commit_id":"ba674d4d592fb9a0aaa08b67d9e22ea97945a76e"}],"doc/user-guides/index.rst":[{"author":{"_account_id":10517,"name":"Jamie Hannaford","email":"jamie.hannaford@rackspace.com","username":"jamiehannaford"},"change_message_id":"870ee50ea08f61f8348e70a53c6be2a79d6983e9","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. PHP SDK for OpenStack documentation master file, created by"},{"line_number":2,"context_line":"   sphinx-quickstart on Tue Apr 29 16:43:30 2014."},{"line_number":3,"context_line":"   You can adapt this file completely to your liking, but it should at least"},{"line_number":4,"context_line":"   contain the root `toctree` directive."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_d6015006","line":1,"updated":"2014-05-06 09:01:24.000000000","message":"Do we need this auto-generated header?","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"73a6d633e40eada6c60e10f013f80d24d97f4d79","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. PHP SDK for OpenStack documentation master file, created by"},{"line_number":2,"context_line":"   sphinx-quickstart on Tue Apr 29 16:43:30 2014."},{"line_number":3,"context_line":"   You can adapt this file completely to your liking, but it should at least"},{"line_number":4,"context_line":"   contain the root `toctree` directive."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_f991e047","line":1,"in_reply_to":"9ad9bd40_d6015006","updated":"2014-05-06 13:09:29.000000000","message":"No, I\u0027ll remove it. Thanks.","commit_id":"0471367888d04716aca789b84042a3ece4d272db"},{"author":{"_account_id":10161,"name":"Shaunak Kashyap","email":"shaunak.kashyap@rackspace.com","username":"ycombinator"},"change_message_id":"86b793ce83ff948cbbaa54f93e51340fecbc7066","unresolved":false,"context_lines":[{"line_number":1,"context_line":".. PHP SDK for OpenStack documentation master file, created by"},{"line_number":2,"context_line":"   sphinx-quickstart on Tue Apr 29 16:43:30 2014."},{"line_number":3,"context_line":"   You can adapt this file completely to your liking, but it should at least"},{"line_number":4,"context_line":"   contain the root `toctree` directive."}],"source_content_type":"text/x-rst","patch_set":1,"id":"9ad9bd40_99aff429","line":1,"in_reply_to":"9ad9bd40_f991e047","updated":"2014-06-01 23:50:27.000000000","message":"Done","commit_id":"0471367888d04716aca789b84042a3ece4d272db"}],"doc/user-guides/object-store/getting-started.rst":[{"author":{"_account_id":8512,"name":"Matt Farina","email":"matt@mattfarina.com","username":"mattfarina"},"change_message_id":"9489d2e893a2d04e124c9bbd3dc3fb6a28cc7557","unresolved":false,"context_lines":[{"line_number":4,"context_line":""},{"line_number":5,"context_line":"Next Steps"},{"line_number":6,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":7,"context_line":"See :doc:`complete-user-guide`"}],"source_content_type":"text/x-rst","patch_set":6,"id":"1ae5cdf2_d72e8442","line":7,"updated":"2014-06-12 19:06:04.000000000","message":"The complete-user-guide isn\u0027t in any doctree which causes the message `/home/mfarina/Code/OS/openstack-sdk-php/doc/user-guides/object-store/complete-user-guide.rst:: WARNING: document isn\u0027t included in any toctree`.\n\nCan we get a toctree that shows the structure for object storage but maybe has the hidden property so it doesn\u0027t display.\n\nThere\u0027s more info on this at http://sphinx-doc.org/markup/toctree.html","commit_id":"ba674d4d592fb9a0aaa08b67d9e22ea97945a76e"}]}