Re: [openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf
On 2014-08-16 04:01:25 +0200 (+0200), Chmouel Boudjnah wrote: If like me you find it difficult to read a large text file like the rst specs inside gerrit diff interface viewer, I have created a script that gets rst files in a review to generate them in a html or pdf files and open it with your desktop default viewer (linux/mac) . [...] Not to detract from your suggestion, but if the specs project in question has a docs job then the link zuul leaves for it in each check report takes you to a draft rendering of the specs with the change applied rather than a log of that particular job. -- Jeremy Stanley ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf
On Sat, Aug 16, 2014 at 7:34 PM, Jeremy Stanley fu...@yuggoth.org wrote: Not to detract from your suggestion, but if the specs project in question has a docs job then the link zuul leaves for it in each check report takes you to a draft rendering of the specs with the change applied rather than a log of that particular job. yes indeed and that's super useful, but it was just a bit too many clicks for me on the review (and to look in the doc for the spec that was proposed in the patchset). Chmouel ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
Re: [openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf
+1 to that, just `tox -e docs` and open the generated file under doc/build/html Regards, Steve Martinelli Software Developer - OpenStack Keystone Core Member Phone: 1-905-413-2851 E-mail: steve...@ca.ibm.com 8200 Warden Ave Markham, ON L6G 1C7 Canada Joe Gordon joe.gord...@gmail.com wrote on 08/16/2014 02:30:31 PM: From: Joe Gordon joe.gord...@gmail.com To: OpenStack Development Mailing List openstack-dev@lists.openstack.org, Date: 08/16/2014 02:32 PM Subject: Re: [openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf On Aug 16, 2014 10:37 AM, Jeremy Stanley fu...@yuggoth.org wrote: On 2014-08-16 04:01:25 +0200 (+0200), Chmouel Boudjnah wrote: If like me you find it difficult to read a large text file like the rst specs inside gerrit diff interface viewer, I have created a script that gets rst files in a review to generate them in a html or pdf files and open it with your desktop default viewer (linux/mac) . [...] Not to detract from your suggestion, but if the specs project in question has a docs job then the link zuul leaves for it in each check report takes you to a draft rendering of the specs with the change applied rather than a log of that particular job. And in nova-specs you just do 'tox -edocs' to build html -- Jeremy Stanley ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev
[openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf
Hello, If like me you find it difficult to read a large text file like the rst specs inside gerrit diff interface viewer, I have created a script that gets rst files in a review to generate them in a html or pdf files and open it with your desktop default viewer (linux/mac) . Script is available here : https://gist.github.com/chmouel/1db66bd76e7fcbc7a13e (need gerritlib/requests/docutils and rst2pdf if the pdf generation is chosen) Chmouel ___ OpenStack-dev mailing list OpenStack-dev@lists.openstack.org http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev