Open Stack

On 04/16/2014 10:31 AM, Balázs Gibizer wrote:
> Hi,
> 
>  
> 
> I’ve just uploaded a new BP proposal to gerrit
>  https://review.openstack.org/#/c/87978,  but the gate failed as I
> included an image along with the .rst file in my patch. What is the good
> place to store the images that are used in the specs?

That just came up in a Neutron thread:

http://lists.openstack.org/pipermail/openstack-dev/2014-April/032885.html

My opinion for now is:

1) For simple diagrams, try to just use inline ascii.  Try asciiflow.com
for help making a simple ascii diagram.

2) If you really need an image, I think we have two options:

   a) host it on the wiki and inline it using the 'image' directive
      with a link to the image hosted on the wiki.  Then we don't
      have to deal with managing images in the repo and it's easy
      to view the image while doing a spec review.

   b) Allow images in nova-specs, perhaps in a subdirectory with
      the same name as the spec as a new convention.  The benefit
      is the images are more guaranteed to stay static with the
      spec, as it was during review.  The downside is it's more of
      a pain to review, IMO.

Thoughts?

-- 
Russell Bryant