)]}'
{"/COMMIT_MSG":[{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"a6bd85b00b64ab00bc4eea525c014072ed066395","unresolved":false,"context_lines":[{"line_number":4,"context_line":"Commit:     Megan Guiney \u003cmeganmguiney@gmail.com\u003e"},{"line_number":5,"context_line":"CommitDate: 2017-03-01 19:22:45 -0800"},{"line_number":6,"context_line":""},{"line_number":7,"context_line":"updated spec to reflect discussion from 2/28/17 refstack meeting"},{"line_number":8,"context_line":""},{"line_number":9,"context_line":"Change-Id: Id409c9bb45955ced41c7d85d8766247f50439b67"}],"source_content_type":"text/x-gerrit-commit-message","patch_set":4,"id":"9a30ddce_b5abc288","line":7,"range":{"start_line":7,"start_character":0,"end_line":7,"end_character":64},"updated":"2017-03-07 18:02:35.000000000","message":"How about keep the original title and use the \"update .. \" sentence as content? \n\nSpec for adding RefStack docs to the website natively\n\nUpdate spec to reflect discussion from 2/28/17 refstack meeting [1]\n[1] http://eavesdrop.openstack.org/meetings/refstack/2017/refstack.2017-02-28-19.00.log.txt","commit_id":"5db7754f9cd2de600ee08ebe705cba8fe0372e5e"}],"specs/pike/approved/add-refstack-docs.rst":[{"author":{"_account_id":7822,"name":"Chris Hoge (not involved in upstream development)","email":"chris@hogepodge.com","username":"hogepodge"},"change_message_id":"19714644021136b3c95003f22084e97c35f650aa","unresolved":false,"context_lines":[{"line_number":22,"context_line":"Duplication of text in the RST into an HTML page is not desired, so we need to"},{"line_number":23,"context_line":"have a tool that can convert RST into simple HTML, and possibly bring those in"},{"line_number":24,"context_line":"as angular templates on the ‘about’ page. This tool can now be executed on"},{"line_number":25,"context_line":"the RefStack server for every release to generate these HTML templates."},{"line_number":26,"context_line":""},{"line_number":27,"context_line":""},{"line_number":28,"context_line":"Possible libraries to use:"}],"source_content_type":"text/x-rst","patch_set":1,"id":"da36d5c6_98f74f8a","line":25,"range":{"start_line":25,"start_character":30,"end_line":25,"end_character":37},"updated":"2017-02-23 22:13:11.000000000","message":"Rather than every release (which has a specific meaning of a tag on the refstack repository which is then deployed by infra), we want to update the docs to capture new patch sets as they land in the refstack repository. From our initial discussions, we were talking about a periodic job (say every 12 hours), similar to how the refstack server refreshes the current guidelines.","commit_id":"bebdaf14f3523e1cf3ac7844eba9052e83c4a9d0"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"a6bd85b00b64ab00bc4eea525c014072ed066395","unresolved":false,"context_lines":[{"line_number":8,"context_line":""},{"line_number":9,"context_line":"This specification defines the changes to the \"About\" page of the RefStack"},{"line_number":10,"context_line":"website in that are neccessary in order to allow RefStack documentation to be"},{"line_number":11,"context_line":"displayed on the RefStack site."},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"Problem description"},{"line_number":14,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a30ddce_f5affae0","line":11,"range":{"start_line":11,"start_character":13,"end_line":11,"end_character":30},"updated":"2017-03-07 18:02:35.000000000","message":"How about:\n\n\"the RefStack site\"  --\u003e \"the RefStack site natively\".","commit_id":"5db7754f9cd2de600ee08ebe705cba8fe0372e5e"},{"author":{"_account_id":17716,"name":"Luz Cazares","email":"luz.cazares@intel.com","username":"luzcazares"},"change_message_id":"84fe672d5c0ec6eb672cc1fef10849586ea6743f","unresolved":false,"context_lines":[{"line_number":38,"context_line":"Alternatives"},{"line_number":39,"context_line":"------------"},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"None"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"Data model impact"},{"line_number":44,"context_line":"-----------------"}],"source_content_type":"text/x-rst","patch_set":4,"id":"9a30ddce_a4355247","line":41,"range":{"start_line":41,"start_character":0,"end_line":41,"end_character":4},"updated":"2017-03-07 19:39:06.000000000","message":"two alternative options:\n1. Use sphinx mechanism to create the HTML sintaxis (downside is sphinx add extra JS code which does not fit with angular, may need a custom sphinx theme, more expensive than docutils option)\n2. Host Refstack documentation at docs.openstack.org (downside - still hosted outside refstack server, create dependency with docs team) - option need further exploration.","commit_id":"5db7754f9cd2de600ee08ebe705cba8fe0372e5e"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"7388649c8fbb0a2120ecac959643ceef15401a3a","unresolved":false,"context_lines":[{"line_number":18,"context_line":"the RefStack site. Currently, documentation is maintained as RST files in the"},{"line_number":19,"context_line":"‘doc’ folder of the RefStack repository, but it would be great to also make"},{"line_number":20,"context_line":"it possible to view them as HTML files via the website."},{"line_number":21,"context_line":""},{"line_number":22,"context_line":""},{"line_number":23,"context_line":"Proposed change"},{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":5,"id":"1a1ced50_bb1d8dbf","line":21,"updated":"2017-03-17 02:23:57.000000000","message":"I think there are two audience here and would suggest two doc sets, likely with different source files in order to best fit within the codebase:\n1. User docs for Refstack itself: One set, written in something that is integral to the RefStack app, which is AngularJS. I\u0027d suggest something like the source files here: https://github.com/angular/angular.js/tree/master/docs/content/guide that helps people (like me) who need to use RefStack for the intended purpose of uploading test results. I would honestly prioritize this highest, because it\u0027s really difficult to follow step-wise instructions when there\u0027s no navigation available other than the back button in your browser.\n2. Contributor docs for community members wanting to contribute: Second set, written in Sphinx/RST, which tells contributors how to work on refstack/interop within OpenStack governance.\n\nTo me, this is the crux of the problem description: need for addressing different docs for different use cases and different toolsets.","commit_id":"d68ec7090ce9b9484b2a0fdb2bae7d19204d1dbc"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"2f3f0bcecbe8f8fa5fd555f6fcde62098304d6de","unresolved":false,"context_lines":[{"line_number":24,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":25,"context_line":""},{"line_number":26,"context_line":"As mentioned above, it would be ideal to be able to access RefStack"},{"line_number":27,"context_line":"documentation in HTML format. The current plan is to use doctools in"},{"line_number":28,"context_line":"combination with sphinx in order to create HTML templates which will then"},{"line_number":29,"context_line":"be able to be integrated into the existing RefStack website."},{"line_number":30,"context_line":""}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_00247b0c","line":27,"range":{"start_line":27,"start_character":57,"end_line":27,"end_character":65},"updated":"2017-03-30 22:44:29.000000000","message":"Is this docutils ?","commit_id":"cba790eed2c4193cd67f76532b1e277e740b3616"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"2f3f0bcecbe8f8fa5fd555f6fcde62098304d6de","unresolved":false,"context_lines":[{"line_number":28,"context_line":"combination with sphinx in order to create HTML templates which will then"},{"line_number":29,"context_line":"be able to be integrated into the existing RefStack website."},{"line_number":30,"context_line":""},{"line_number":31,"context_line":"Another goal of this documentation update will be to separate docs intended"},{"line_number":32,"context_line":"for users from the rest of the docs, in order to ensure that they will be"},{"line_number":33,"context_line":"more easily accessed by end users. These docs will be displayed on the"},{"line_number":34,"context_line":"the RefStack website. A second set of docs, the RefStack Project docs,"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_a0626f15","line":31,"range":{"start_line":31,"start_character":53,"end_line":31,"end_character":61},"updated":"2017-03-30 22:44:29.000000000","message":"As discussed at the IRC meeting [1], RefStack docs will be published to two sites (the RefStack and OpenStack doc sites). A portion of the docs ( user specific) will be hosted at the RefStack website while all docs (RefStack Project and user docs) will be published at the OpenStack docs site. \n\n[1] http://eavesdrop.openstack.org/meetings/refstack/2017/refstack.2017-03-28-19.03.log.txt","commit_id":"cba790eed2c4193cd67f76532b1e277e740b3616"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"2f3f0bcecbe8f8fa5fd555f6fcde62098304d6de","unresolved":false,"context_lines":[{"line_number":40,"context_line":""},{"line_number":41,"context_line":"sphinx"},{"line_number":42,"context_line":""},{"line_number":43,"context_line":"doctools"},{"line_number":44,"context_line":""},{"line_number":45,"context_line":"Alternatives"},{"line_number":46,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_a0782ff8","line":43,"range":{"start_line":43,"start_character":0,"end_line":43,"end_character":8},"updated":"2017-03-30 22:44:29.000000000","message":"ditto","commit_id":"cba790eed2c4193cd67f76532b1e277e740b3616"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"2f3f0bcecbe8f8fa5fd555f6fcde62098304d6de","unresolved":false,"context_lines":[{"line_number":115,"context_line":"Documentation Impact"},{"line_number":116,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":117,"context_line":""},{"line_number":118,"context_line":"Documentation will now be available on the RefStack website in simple HTML"},{"line_number":119,"context_line":"format. It will be listed under the \"About\" section on the main menu bar. This"},{"line_number":120,"context_line":"will be a change from the current state in that users will be able to view"},{"line_number":121,"context_line":"documentation concerning running tests and uploading results in a format which"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_200d3f3e","line":118,"range":{"start_line":118,"start_character":0,"end_line":118,"end_character":13},"updated":"2017-03-30 22:44:29.000000000","message":"User specific documents will ...","commit_id":"cba790eed2c4193cd67f76532b1e277e740b3616"},{"author":{"_account_id":10526,"name":"Catherine Diep","email":"cdiep@us.ibm.com","username":"cdiep"},"change_message_id":"2f3f0bcecbe8f8fa5fd555f6fcde62098304d6de","unresolved":false,"context_lines":[{"line_number":122,"context_line":"is similar to the rest of the RefStack website."},{"line_number":123,"context_line":""},{"line_number":124,"context_line":"RefStack documentation will now also be available on the main OpenStack docs"},{"line_number":125,"context_line":"site. These docs will use the same source as those hosted on the RefStack site."},{"line_number":126,"context_line":""},{"line_number":127,"context_line":"References"},{"line_number":128,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":7,"id":"dfeb2761_8303f50d","line":125,"range":{"start_line":125,"start_character":30,"end_line":125,"end_character":41},"updated":"2017-03-30 22:44:29.000000000","message":"++","commit_id":"cba790eed2c4193cd67f76532b1e277e740b3616"}]}