)]}'
{"specs/ocata/build-pdf-from-rst-guides.rst":[{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Generating PDF doc files for current openstack-manuals documents"},{"line_number":16,"context_line":"and providing PDF download URLs to each HTML document is helpful for"},{"line_number":17,"context_line":"users who want to see documents in offline."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Problem description"},{"line_number":20,"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":1,"id":"fa7ab95a_0c189b74","line":17,"range":{"start_line":17,"start_character":32,"end_line":17,"end_character":34},"updated":"2016-09-01 17:52:07.000000000","message":"remove","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":14,"context_line":""},{"line_number":15,"context_line":"Generating PDF doc files for current openstack-manuals documents"},{"line_number":16,"context_line":"and providing PDF download URLs to each HTML document is helpful for"},{"line_number":17,"context_line":"users who want to see documents in offline."},{"line_number":18,"context_line":""},{"line_number":19,"context_line":"Problem description"},{"line_number":20,"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":1,"id":"9a89bdaa_16030ab9","line":17,"range":{"start_line":17,"start_character":32,"end_line":17,"end_character":34},"in_reply_to":"fa7ab95a_0c189b74","updated":"2016-09-07 23:27:23.000000000","message":"Done","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":29,"context_line":"versions of the books. Current HTML documents are surely helpful,"},{"line_number":30,"context_line":"but having PDF versions provides OpenStack documentation readers"},{"line_number":31,"context_line":"with more additional benefits. For example, users can download PDF files"},{"line_number":32,"context_line":"and read them in offline. To print HTML documents, users do more manual"},{"line_number":33,"context_line":"steps such as moving from one page to other pages and the printed layout"},{"line_number":34,"context_line":"is different from what users see through monitors. Furthermore,"},{"line_number":35,"context_line":"it is easier for users to share their personal notes in PDF files with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_619cd00e","line":32,"range":{"start_line":32,"start_character":14,"end_line":32,"end_character":16},"updated":"2016-09-01 17:52:07.000000000","message":"remove","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":29,"context_line":"versions of the books. Current HTML documents are surely helpful,"},{"line_number":30,"context_line":"but having PDF versions provides OpenStack documentation readers"},{"line_number":31,"context_line":"with more additional benefits. For example, users can download PDF files"},{"line_number":32,"context_line":"and read them in offline. To print HTML documents, users do more manual"},{"line_number":33,"context_line":"steps such as moving from one page to other pages and the printed layout"},{"line_number":34,"context_line":"is different from what users see through monitors. Furthermore,"},{"line_number":35,"context_line":"it is easier for users to share their personal notes in PDF files with"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_f6f786d0","line":32,"range":{"start_line":32,"start_character":14,"end_line":32,"end_character":16},"in_reply_to":"fa7ab95a_619cd00e","updated":"2016-09-07 23:27:23.000000000","message":"Done","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":34,"context_line":"is different from what users see through monitors. Furthermore,"},{"line_number":35,"context_line":"it is easier for users to share their personal notes in PDF files with"},{"line_number":36,"context_line":"other readers. One more advantage using PDF files is that PDF files have"},{"line_number":37,"context_line":"pages. For instance, users can say \"Please see page X in the PDF file\""},{"line_number":38,"context_line":"instead of pointing out such as \"Browse the HTML document, click section A"},{"line_number":39,"context_line":"and B, and find topic C\"."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Proposed change"},{"line_number":42,"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":1,"id":"fa7ab95a_ec5ff70c","line":39,"range":{"start_line":37,"start_character":7,"end_line":39,"end_character":25},"updated":"2016-09-01 17:58:32.000000000","message":"On the other hand: For bug reports, I prefer html, you can link to a section. Page X might look different after some additional content merged. But a link to a section does not change in general","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":34,"context_line":"is different from what users see through monitors. Furthermore,"},{"line_number":35,"context_line":"it is easier for users to share their personal notes in PDF files with"},{"line_number":36,"context_line":"other readers. One more advantage using PDF files is that PDF files have"},{"line_number":37,"context_line":"pages. For instance, users can say \"Please see page X in the PDF file\""},{"line_number":38,"context_line":"instead of pointing out such as \"Browse the HTML document, click section A"},{"line_number":39,"context_line":"and B, and find topic C\"."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Proposed change"},{"line_number":42,"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":1,"id":"9a89bdaa_f6cce68a","line":39,"range":{"start_line":37,"start_character":7,"end_line":39,"end_character":25},"in_reply_to":"fa7ab95a_6c7f6717","updated":"2016-09-07 23:27:23.000000000","message":"My original thought is the benefit in offline training environment such as self-paced labs, not bug report. I agree that on bug report indicating PDF pages is not a good idea. So I changed the sentence by clarifying the usefulness in offline training environment.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":34,"context_line":"is different from what users see through monitors. Furthermore,"},{"line_number":35,"context_line":"it is easier for users to share their personal notes in PDF files with"},{"line_number":36,"context_line":"other readers. One more advantage using PDF files is that PDF files have"},{"line_number":37,"context_line":"pages. For instance, users can say \"Please see page X in the PDF file\""},{"line_number":38,"context_line":"instead of pointing out such as \"Browse the HTML document, click section A"},{"line_number":39,"context_line":"and B, and find topic C\"."},{"line_number":40,"context_line":""},{"line_number":41,"context_line":"Proposed change"},{"line_number":42,"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":1,"id":"fa7ab95a_6c7f6717","line":39,"range":{"start_line":37,"start_character":7,"end_line":39,"end_character":25},"in_reply_to":"fa7ab95a_ec5ff70c","updated":"2016-09-01 18:11:40.000000000","message":"Please don\u0027t refer to page numbers as beneficial for bug reporting. We can merge 50 changes a day so the page numbering can change numerous times and links even to sections are much easier to ensure as accurate for pointers.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":46,"context_line":""},{"line_number":47,"context_line":"After Sphinx build supports PDF file generation, apply PDF buildings to"},{"line_number":48,"context_line":"all the HTML documents in openstack-manuals repository, add the build"},{"line_number":49,"context_line":"job to work with HTML builds, publish PDF files on docs.openstack.org,"},{"line_number":50,"context_line":"and finally insert PDF download URLs in HTML documents."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_a1e898e3","line":50,"range":{"start_line":49,"start_character":30,"end_line":50,"end_character":55},"updated":"2016-09-01 17:52:07.000000000","message":"How do you propose to publish the PDFs? How will they be archived? Will you have only PDFs for the latest release? I am not opposed to offering PDF generation on demand, as you suggested via a link on the HTML documents. However, curating PDF files for the documentation can very quickly become very time consuming.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":46,"context_line":""},{"line_number":47,"context_line":"After Sphinx build supports PDF file generation, apply PDF buildings to"},{"line_number":48,"context_line":"all the HTML documents in openstack-manuals repository, add the build"},{"line_number":49,"context_line":"job to work with HTML builds, publish PDF files on docs.openstack.org,"},{"line_number":50,"context_line":"and finally insert PDF download URLs in HTML documents."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_ac97af8e","line":50,"range":{"start_line":49,"start_character":30,"end_line":50,"end_character":55},"in_reply_to":"fa7ab95a_a1e898e3","updated":"2016-09-01 17:58:32.000000000","message":"Like we did in the past: Whenever we build html, we put a PDF file besides the index.html file and link to it.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":46,"context_line":""},{"line_number":47,"context_line":"After Sphinx build supports PDF file generation, apply PDF buildings to"},{"line_number":48,"context_line":"all the HTML documents in openstack-manuals repository, add the build"},{"line_number":49,"context_line":"job to work with HTML builds, publish PDF files on docs.openstack.org,"},{"line_number":50,"context_line":"and finally insert PDF download URLs in HTML documents."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_cca15396","line":50,"range":{"start_line":49,"start_character":30,"end_line":50,"end_character":55},"in_reply_to":"fa7ab95a_ac97af8e","updated":"2016-09-01 18:11:40.000000000","message":"I agree with a PDF-per-build and link to it from the landing page of the HTML output.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":46,"context_line":""},{"line_number":47,"context_line":"After Sphinx build supports PDF file generation, apply PDF buildings to"},{"line_number":48,"context_line":"all the HTML documents in openstack-manuals repository, add the build"},{"line_number":49,"context_line":"job to work with HTML builds, publish PDF files on docs.openstack.org,"},{"line_number":50,"context_line":"and finally insert PDF download URLs in HTML documents."},{"line_number":51,"context_line":""},{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_b6e97eb9","line":50,"range":{"start_line":49,"start_character":30,"end_line":50,"end_character":55},"in_reply_to":"fa7ab95a_cca15396","updated":"2016-09-07 23:27:23.000000000","message":"+1 for adding PDF link to the landing page on each document.\n\nNote: But in the past PDF download link was in every page, like: http://docs.openstack.org/kilo/install-guide/install/apt/content/ch_preface.html (pdf icon on the middle).","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"If adding build jobs into openstack-infra is difficult due to such as"},{"line_number":56,"context_line":"installation fails with package depencencies, building PDF files"},{"line_number":57,"context_line":"in offline, uploading them into docs.openstack.org and insert download"},{"line_number":58,"context_line":"links in HTML documents would be possible alternative approach."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Implementation"},{"line_number":61,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_4cd62350","line":58,"range":{"start_line":55,"start_character":0,"end_line":58,"end_character":63},"updated":"2016-09-01 17:58:32.000000000","message":"you do not need to change anything in infra here, you only need to change openstack-doc-tools for our scripts and openstack-manuals etc to use them.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":52,"context_line":"Alternatives"},{"line_number":53,"context_line":"------------"},{"line_number":54,"context_line":""},{"line_number":55,"context_line":"If adding build jobs into openstack-infra is difficult due to such as"},{"line_number":56,"context_line":"installation fails with package depencencies, building PDF files"},{"line_number":57,"context_line":"in offline, uploading them into docs.openstack.org and insert download"},{"line_number":58,"context_line":"links in HTML documents would be possible alternative approach."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Implementation"},{"line_number":61,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_367c8eb4","line":58,"range":{"start_line":55,"start_character":0,"end_line":58,"end_character":63},"in_reply_to":"fa7ab95a_4cd62350","updated":"2016-09-07 23:27:23.000000000","message":"Done","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":56,"context_line":"installation fails with package depencencies, building PDF files"},{"line_number":57,"context_line":"in offline, uploading them into docs.openstack.org and insert download"},{"line_number":58,"context_line":"links in HTML documents would be possible alternative approach."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Implementation"},{"line_number":61,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":62,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_8ce90bba","line":59,"updated":"2016-09-01 18:11:40.000000000","message":"To me, another alternative would be to document how to make PDF files for others to make them.\n\nBe sure you indicate that the work is in these repos:\nopenstack-doc-tools\nopenstackdocstheme","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":56,"context_line":"installation fails with package depencencies, building PDF files"},{"line_number":57,"context_line":"in offline, uploading them into docs.openstack.org and insert download"},{"line_number":58,"context_line":"links in HTML documents would be possible alternative approach."},{"line_number":59,"context_line":""},{"line_number":60,"context_line":"Implementation"},{"line_number":61,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":62,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_16586a55","line":59,"in_reply_to":"fa7ab95a_8ce90bba","updated":"2016-09-07 23:27:23.000000000","message":"Thanks! I originally thought that \u0027Alternatives\u0027 section is to describe such as what if the proposed spec will not work. Done.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":73,"context_line":"----------"},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"* Identifying requirements of libraries including rst2pdf"},{"line_number":76,"context_line":"* Checking tex library support (installation \u0026 compatibility) in current"},{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_6c3e878c","line":77,"range":{"start_line":76,"start_character":2,"end_line":77,"end_character":1},"updated":"2016-09-01 17:58:32.000000000","message":"I would prefer to not use TeX - that\u0027s a lot to install","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":73,"context_line":"----------"},{"line_number":74,"context_line":""},{"line_number":75,"context_line":"* Identifying requirements of libraries including rst2pdf"},{"line_number":76,"context_line":"* Checking tex library support (installation \u0026 compatibility) in current"},{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_1606aa1f","line":77,"range":{"start_line":76,"start_character":2,"end_line":77,"end_character":1},"in_reply_to":"fa7ab95a_6c3e878c","updated":"2016-09-07 23:27:23.000000000","message":"I also prefer not to use TeX. I thought rst2pdf has a dependency on TeX. I am not still sure, but recently I have found that just rst2pdf will be sufficient to build PDFs. So I revised the sentence without mentioning TeX.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":76,"context_line":"* Checking tex library support (installation \u0026 compatibility) in current"},{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_617f7017","line":79,"range":{"start_line":79,"start_character":2,"end_line":79,"end_character":19},"updated":"2016-09-01 17:52:07.000000000","message":"What are the requirements for that basic theme?","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":76,"context_line":"* Checking tex library support (installation \u0026 compatibility) in current"},{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_67c78098","line":79,"range":{"start_line":79,"start_character":2,"end_line":79,"end_character":19},"in_reply_to":"fa7ab95a_617f7017","updated":"2016-09-01 18:11:40.000000000","message":"At a minimum, sounds like the PDF requirements are:\n- title page, text only\n- accurate page numbers\n- table of contents entries and links to H1, H2 from TOC\n- inline images are kept inside page print margins\n- tables wrap appropriately for page print margins\n- print target is 8.5x11 (or Euro equivalent, I don\u0027t care but do specify)\n- grey or light color background for any code output for those who do print to save on ink/toner\n- open source font selections\n- file name does not contain spaces or special characters\n\nNot required:\n- index with page numbers\n- OpenStack logo display on title page (choosing which logo is appropriate for each deliverable would get tedious)\n\nOptional:\n- watermark to indicate draft or to which version the document applies","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":76,"context_line":"* Checking tex library support (installation \u0026 compatibility) in current"},{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_41186e75","line":79,"range":{"start_line":79,"start_character":2,"end_line":79,"end_character":19},"in_reply_to":"fa7ab95a_67c78098","updated":"2016-09-07 23:27:23.000000000","message":"Thank you, Anne for mentioning PDF requirements! I added it to the spec.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_cc707375","line":80,"range":{"start_line":80,"start_character":2,"end_line":80,"end_character":40},"updated":"2016-09-01 17:58:32.000000000","message":"we cave have that - but my expectatoin is that \"tox -e checkbuild\" will build both HTML and PDF.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":77,"context_line":"  Sphinx building jobs"},{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_612f323f","line":80,"range":{"start_line":80,"start_character":2,"end_line":80,"end_character":40},"in_reply_to":"fa7ab95a_cc707375","updated":"2016-09-07 23:27:23.000000000","message":"I changed the sentence to \"Integrating building PDF jobs with current tox HTML build environment\" to address your comment.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_2c063fce","line":81,"range":{"start_line":81,"start_character":0,"end_line":81,"end_character":61},"updated":"2016-09-01 17:58:32.000000000","message":"Not needed, let\u0027s do it as part of existing jobs..","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":78,"context_line":"* Changes in Sphinx configuration"},{"line_number":79,"context_line":"* A basic PDF theme (fancy theme design is not the main goal)"},{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_813276a5","line":81,"range":{"start_line":81,"start_character":0,"end_line":81,"end_character":61},"in_reply_to":"fa7ab95a_2c063fce","updated":"2016-09-07 23:27:23.000000000","message":"Done","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"088e1434c81a34f41ccb5f6c71c315327fda3a41","unresolved":false,"context_lines":[{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_ec00d7ad","line":83,"range":{"start_line":83,"start_character":2,"end_line":83,"end_character":19},"updated":"2016-09-01 17:58:32.000000000","message":"security-doc, api-site as well.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":80,"context_line":"* tox environment for building PDF files"},{"line_number":81,"context_line":"* openstack-infra build job to generate and publish PDF files"},{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"Dependencies"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_c1ad5e9c","line":83,"range":{"start_line":83,"start_character":2,"end_line":83,"end_character":19},"in_reply_to":"fa7ab95a_ec00d7ad","updated":"2016-09-07 23:27:23.000000000","message":"I agree that PDF build functionalities will be applied easily to security-doc and api-site as well after the implementation of the functionalities. From now to Ocata, we have time but I first would like to mainly focus on openstack-manuals repository. As the next Anne\u0027s comment, I mentioned those repositories in a separated \u0027Project scope\u0027 section.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"Dependencies"},{"line_number":87,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":88,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_6c412763","line":85,"updated":"2016-09-01 18:11:40.000000000","message":"instead of future, put out of scope for this spec.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":82,"context_line":"* Applying PDF build functionalities to all HTML documents in"},{"line_number":83,"context_line":"  openstack-manuals repository"},{"line_number":84,"context_line":"* (future) support of building PDFs from translated documents"},{"line_number":85,"context_line":""},{"line_number":86,"context_line":"Dependencies"},{"line_number":87,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":88,"context_line":""}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_e17fc212","line":85,"in_reply_to":"fa7ab95a_6c412763","updated":"2016-09-07 23:27:23.000000000","message":"Done","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":964,"name":"Anne Gentle","email":"annegentle@justwriteclick.com","username":"annegentle"},"change_message_id":"cdebbfd50c15300c2a0047633421ba6b13d6db99","unresolved":false,"context_lines":[{"line_number":87,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* pdf build program (e.g., rst2pdf) installation fails with"},{"line_number":90,"context_line":"  package depencencies in openstack-infra"},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_ac26cfcb","line":90,"updated":"2016-09-01 18:11:40.000000000","message":"This is worded oddly... you depend on a failure? Or resolution of that failure?","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":87,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":88,"context_line":""},{"line_number":89,"context_line":"* pdf build program (e.g., rst2pdf) installation fails with"},{"line_number":90,"context_line":"  package depencencies in openstack-infra"},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_e170a20d","line":90,"in_reply_to":"fa7ab95a_ac26cfcb","updated":"2016-09-07 23:27:23.000000000","message":"I thought the latest rst2pdf version might not work because current Sphinx version to build HTMLs is \u003c1.3 AFAIK. I changed my awkward sentence.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":89,"context_line":"* pdf build program (e.g., rst2pdf) installation fails with"},{"line_number":90,"context_line":"  package depencencies in openstack-infra"},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"* Testing of the tools will be done manually and as part of the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_01f78459","line":92,"range":{"start_line":92,"start_character":0,"end_line":92,"end_character":7},"updated":"2016-09-01 17:52:07.000000000","message":"What is your plan to verify the generated PDF files? Things like orphan paragraphs, layout problems, and tables can produce problems in the document and project a very unprofessional image.","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":89,"context_line":"* pdf build program (e.g., rst2pdf) installation fails with"},{"line_number":90,"context_line":"  package depencencies in openstack-infra"},{"line_number":91,"context_line":""},{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"* Testing of the tools will be done manually and as part of the"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_c15c7e7f","line":92,"range":{"start_line":92,"start_character":0,"end_line":92,"end_character":7},"in_reply_to":"fa7ab95a_01f78459","updated":"2016-09-07 23:27:23.000000000","message":"Most verification will be occurred during rst2pdf building jobs. Yes, however, some layout problems (e.g., less image resolution) cannot be verified automatically. Might we need to have beta-reading period using draft landing pages?","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":22141,"name":"Rodrigo Caballero","email":"rodrigo.caballero.abraham@intel.com","username":"rcaballeromx"},"change_message_id":"b3460b7efb638ebfa512a0a19fd8f69059c6b1e4","unresolved":false,"context_lines":[{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"* Testing of the tools will be done manually and as part of the"},{"line_number":96,"context_line":"  builds. We should add some method to do integration testing."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":1,"id":"fa7ab95a_c16bdc1c","line":95,"range":{"start_line":95,"start_character":31,"end_line":95,"end_character":44},"updated":"2016-09-01 17:52:07.000000000","message":"I think this is very unwise. You could have Jenkins do a dry run of the PDF build (performing all steps but not generating any output files).","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"c6941dd091040a61e77885df50ce96114d4e8eb0","unresolved":false,"context_lines":[{"line_number":92,"context_line":"Testing"},{"line_number":93,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":94,"context_line":""},{"line_number":95,"context_line":"* Testing of the tools will be done manually and as part of the"},{"line_number":96,"context_line":"  builds. We should add some method to do integration testing."},{"line_number":97,"context_line":""},{"line_number":98,"context_line":"References"}],"source_content_type":"text/x-rst","patch_set":1,"id":"9a89bdaa_c1eabe73","line":95,"range":{"start_line":95,"start_character":31,"end_line":95,"end_character":44},"in_reply_to":"fa7ab95a_c16bdc1c","updated":"2016-09-07 23:27:23.000000000","message":"I think beta reading period can address this \u0027manual\u0027 stuff. So I added it. Thanks,","commit_id":"fc02217696f0b8dd85cd944d9cc6f6dac4ffe92a"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"134e3dad46491b0e1d92289d8fba4c528c6e92bb","unresolved":false,"context_lines":[{"line_number":8,"context_line":"Build PDF docs from rst-based guide documents"},{"line_number":9,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/build-pdf-from-rst-guides"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_c249d232","line":11,"range":{"start_line":11,"start_character":0,"end_line":11,"end_character":44},"updated":"2016-09-08 07:47:04.000000000","message":"REmove this line, that\u0027s an instruction","commit_id":"9e74224091112f6d44c9c65252b0552c0b1e7299"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"d75e45dadef17d161c4a23f01c9bbe8c095613b5","unresolved":false,"context_lines":[{"line_number":8,"context_line":"Build PDF docs from rst-based guide documents"},{"line_number":9,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":10,"context_line":""},{"line_number":11,"context_line":"Include the URL of your launchpad blueprint:"},{"line_number":12,"context_line":""},{"line_number":13,"context_line":"https://blueprints.launchpad.net/openstack-manuals/+spec/build-pdf-from-rst-guides"},{"line_number":14,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_63d47eeb","line":11,"range":{"start_line":11,"start_character":0,"end_line":11,"end_character":44},"in_reply_to":"9a89bdaa_c249d232","updated":"2016-09-08 11:37:24.000000000","message":"Done","commit_id":"9e74224091112f6d44c9c65252b0552c0b1e7299"},{"author":{"_account_id":6547,"name":"Andreas Jaeger","email":"jaegerandi@gmail.com","username":"jaegerandi"},"change_message_id":"134e3dad46491b0e1d92289d8fba4c528c6e92bb","unresolved":false,"context_lines":[{"line_number":63,"context_line":""},{"line_number":64,"context_line":"Another alternative would be to leave the guide with current HTML build"},{"line_number":65,"context_line":"infrastructure as is."},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Implementation"},{"line_number":68,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":69,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_c2cc728b","line":66,"updated":"2016-09-08 07:47:04.000000000","message":"another alternative - the one Anne : Document how users can built PDFs locally but do not publish PDFs","commit_id":"9e74224091112f6d44c9c65252b0552c0b1e7299"},{"author":{"_account_id":14482,"name":"Ian Y. Choi","email":"ianyrchoi@gmail.com","username":"ianychoi"},"change_message_id":"d75e45dadef17d161c4a23f01c9bbe8c095613b5","unresolved":false,"context_lines":[{"line_number":63,"context_line":""},{"line_number":64,"context_line":"Another alternative would be to leave the guide with current HTML build"},{"line_number":65,"context_line":"infrastructure as is."},{"line_number":66,"context_line":""},{"line_number":67,"context_line":"Implementation"},{"line_number":68,"context_line":"\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d\u003d"},{"line_number":69,"context_line":""}],"source_content_type":"text/x-rst","patch_set":2,"id":"9a89bdaa_63fb9e79","line":66,"in_reply_to":"9a89bdaa_c2cc728b","updated":"2016-09-08 11:37:24.000000000","message":"Oops I missed it, thanks! I added it.","commit_id":"9e74224091112f6d44c9c65252b0552c0b1e7299"}]}