Re: [openstack-dev] [specs] script to help with spec reviews to convert them in html or pdf

2014-08-16 Thread Jeremy Stanley
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

2014-08-16 Thread Chmouel Boudjnah
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

2014-08-16 Thread Steve Martinelli
+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

2014-08-15 Thread Chmouel Boudjnah
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