<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On Fri, Jan 9, 2015 at 12:55 AM, Tom Fifield <span dir="ltr"><<a href="mailto:tom@openstack.org" target="_blank">tom@openstack.org</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi Christian,<br>
<br>
Thanks for the response and highlighting some areas where the repository<br>
layout could be improved.<br>
<br>
I think we can start work on improving that layout without creating a<br>
new repository.<br>
<br>
For example, we can:<br>
* define 'images' as the name of the directory where images within a<br>
particular guide<br>
* ensuring source and used images both exist<br>
* ensuring source and used images are named the same and differ only in<br>
their file extension<br>
<br>
Do they sound like reasonable first steps?<br>
<br></blockquote><div><br></div><div>These sound reasonable to me. </div><div><br></div><div>Once we get agreement here, I'll update the Documentation/HowTo wiki page with this guidance. It's not a style guide for images, yet, but for the file management itself.</div><div><br></div><div>There's still a lingering couple of related questions: </div><div>Do we as a team require only standard formats (such as svg) for source files?</div><div>Do we as a team need to track down source files for all current images and convert them to svg?</div><div><br></div><div>Anne</div><div> </div><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Once we've got all that in order, maybe then we can revisit the need to<br>
create a whole new repository and the complexity it entails.<br>
<br>
<br>
Screenshots seem to be a parallel issue for another thread - but I have<br>
to say, yes, I too would love to see automated screenshots :) I'd see it<br>
working in the same way as the Translations proposal bot.<br>
<br>
Regards,<br>
<br>
<br>
Tom<br>
<span class="im HOEnZb"><br>
On 08/01/15 17:43, Christian Berendt wrote:<br>
> On 01/08/2015 09:26 AM, Tom Fifield wrote:<br>
>> * Is the additional complexity of differing 'source' and 'use' locations<br>
>> worthwhile?<br>
><br>
> I think so because at the moment all graphics (source and rendered) life<br>
> inside documentation repositories without any specific convention.<br>
><br>
> For example the graphics of image-guide are located in a directory<br>
> figures, the graphics of arch-design are located in a directory images.<br>
><br>
> Also there are a lot of screenshots out of date. This should be<br>
> discussed, too. There are tools like <a href="http://phantomjs.org/" target="_blank">http://phantomjs.org/</a> to automate<br>
> screen capturing. This way we could keep screenshots up to date.<br>
><br>
>> * Is increasing the number of places needing to be changed for a fix<br>
>> justified?<br>
><br>
> We have a lot of documentation repostiories and at the moment it is hard<br>
> to find the source of a specific graphic or a specific graphic itself.<br>
> For example there is only one Graffle file in arch-design but a lot of<br>
> PNG files.<br>
><br>
>> * How will the changes be communicated? What HowToContribute guides<br>
>> needs to be updated?<br>
><br>
> This mailinglist and <a href="https://wiki.openstack.org/wiki/Documentation/HowTo" target="_blank">https://wiki.openstack.org/wiki/Documentation/HowTo</a>.<br>
><br>
> Christian.<br>
><br>
<br>
<br>
</span><div class="HOEnZb"><div class="h5">_______________________________________________<br>
OpenStack-docs mailing list<br>
<a href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack.org</a><br>
<a href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</div></div></blockquote></div><br></div></div>