<div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote">On 8 September 2016 at 12:02, Anne Gentle <span dir="ltr"><<a target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a>></span> wrote:<br><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span class="gmail-">On Wed, Sep 7, 2016 at 8:07 PM, Brian Moss <span dir="ltr"><<a target="_blank" href="mailto:kallimachos@gmail.com">kallimachos@gmail.com</a>></span> wrote:<br><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote"><div dir="ltr"><span>On 7 September 2016 at 23:49, Anne Gentle <span dir="ltr"><<a target="_blank" href="mailto:annegentle@justwriteclick.com">annegentle@justwriteclick.com</a><wbr>></span> wrote:<br></span><div class="gmail_extra"><div class="gmail_quote"><span><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><br><div class="gmail_extra"><br><div class="gmail_quote"><span>On Wed, Sep 7, 2016 at 1:51 AM, Brian Moss <span dir="ltr"><<a target="_blank" href="mailto:kallimachos@gmail.com">kallimachos@gmail.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div><div><div>Hi Mahesh,<br><br></div>Glad you like it! I think we
want the image to repeat down the page so if someone links to the
middle of a long page they still have an indication of which version
they are looking at. However, perhaps the spacing between images can be
increased so they do not appear as frequently.<br><br></div>I've filed a
couple of issues for sphinxmark to add these as config options so we
can experiment and find the best look for the OpenStack docs.<br><br><a target="_blank" href="https://github.com/kallimachos/sphinxmark/issues/12">https://github.com/kallimachos<wbr>/sphinxmark/issues/12</a><br><a target="_blank" href="https://github.com/kallimachos/sphinxmark/issues/13">https://github.com/kallimachos<wbr>/sphinxmark/issues/13</a></div></div></div></blockquote><div><br></div><div><br></div></span><div>If the solution is experimental, and the readability is poor, let's revert until we have a design we've all agreed to. Right now I find it really distracting and hard to read. Maybe I missed the design phase -- totally possible -- but the current overlay watermark makes the Mitaka install guide not readable.</div><div><br></div><div>Can you come up with some next steps and let us know the plan?</div><div><br></div><div>Anne</div></div></div></div></blockquote><div><br></div></span><div>A few options that are immediately available would be to reduce the opacity of the watermark, change its color, and/or reduce the font size. For example, the current opacity is 40. This is what it looks like set to 10:<br><br><a target="_blank" href="http://docs-draft.openstack.org/29/367029/1/check/gate-openstack-manuals-tox-doc-publish-checkbuild/4b8dd8c//publish-docs/draft/install-guide-ubuntu/index.html">http://docs-draft.openstack.or<wbr>g/29/367029/1/check/gate-opens<wbr>tack-manuals-tox-doc-publish-c<wbr>heckbuild/4b8dd8c//publish-doc<wbr>s/draft/install-guide-ubuntu/i<wbr>ndex.html</a><br><br></div><div>Alternatively, an image can be used in place of the text if we have one that is more suitable than the text-based solution.<br></div><div><br></div><div>If the concern is with having the watermark behind the text and we want it somewhere else on the page, that will require a bit more effort to implement.<br><br></div><div>If the above config options don't provide the desired result, watermarks can be turned off by setting 'sphinxmark_enable = False' in the conf.py files of the relevant books.<br></div><div><br></div><div>If you have a particular look in mind, let me know and I'll see what I can do to make it happen. :)</div></div></div></div></blockquote><div><br></div></span><div>At the risk of sounding like I'm late to the party or simply being a grumpy cat, I need to point out that the bug you worked against doesn't talk about the design. <a target="_blank" href="https://bugs.launchpad.net/openstack-manuals/+bug/1479166">https://bugs.launchpad<wbr>.net/openstack-manuals/+bug/<wbr>1479166</a> </div><div><br></div><div>Ideally this solution would have been designed, gotten feedback, tested, then implemented. Right now you're getting feedback so there's still work to be done to get a design then do the right implementation.</div><div><br></div><div>Ideas:</div><div><div>* The versioning indicator designs I get the most positive response to are the ones on <a target="_blank" href="http://readthedocs.org">readthedocs.org</a>. It's in the corner, stays in the same place regardless of scroll point, and it provides links to other versions. Seems to address comment #3 in the bug above more than a background watermark does.</div><div><br></div><div>* The design for a watermark we had in the past was vertical rather than horizontal and did not overlap any text. <a target="_blank" href="http://docs.openstack.org/icehouse/install-guide/install/apt-debian/content/">http://docs.openstack.org/<wbr>icehouse/install-guide/<wbr>install/apt-debian/content/</a> <wbr>Your second iteration of more transparency helps but still overlaps the text. </div></div><div><br></div><div>I'd like more design work up-front please, and more explanation in the bug of how the design addressed the concerns. We can get more use out of this beyond the install guide if it's designed based on input. Think of the CLI guides, they are not tied to a release name but a release number. Can your solution solve for more uses than a word-based release name? </div><div>Anne</div><span class="gmail-"><div><br></div></span></div></div></div></blockquote><div><br></div><div>I've updated <a href="https://bugs.launchpad.net/openstack-manuals/+bug/1479166">https://bugs.launchpad.net/openstack-manuals/+bug/1479166</a> with some design-related thoughts. If everyone would like to jump in there we can ruminate as a group.<br><br></div><div>Cheers,<br><br></div><div>Brian<br></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span class="gmail-"><div></div><div> </div><blockquote style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex" class="gmail_quote"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><div><span><font color="#888888"><br></font></span></div><span><font color="#888888"><div><br></div><div>Brian<br></div></font></span><span><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_extra"><div class="gmail_quote"><span><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div><div><br><br></div>Cheers,<br><br></div>Brian<br><div class="gmail_extra"><br><div class="gmail_quote"><div><div>On 7 September 2016 at 15:12, venkata mahesh <span dir="ltr"><<a target="_blank" href="mailto:venkatamaheshkotha@gmail.com">venkatamaheshkotha@gmail.com</a>></span> wrote:<br></div></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div><div><div dir="ltr"><div><div><div>Hi team,<br><br></div>The addition of release name (Mitaka) in the background is nice. My suggestion is make this version name Mitaka in the background only one in each page. Now it is having more than five ( Mitaka )images in background that will distract the reader.<br><br></div>Thanks<span><font color="#888888"><br></font></span></div><span><font color="#888888">mahesh<br></font></span></div>
<br></div></div>______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack<wbr>.org</a><br>
<a target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-docs</a><br>
<br></blockquote></div><br></div></div>
<br>______________________________<wbr>_________________<br>
OpenStack-docs mailing list<br>
<a target="_blank" href="mailto:OpenStack-docs@lists.openstack.org">OpenStack-docs@lists.openstack<wbr>.org</a><br>
<a target="_blank" href="http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs" rel="noreferrer">http://lists.openstack.org/cgi<wbr>-bin/mailman/listinfo/openstac<wbr>k-docs</a><br>
<br></blockquote></span></div><span><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a target="_blank" href="http://www.justwriteclick.com" style="font-size:12.8px">www.justwriteclick.com</a><br></div></div></div></div></div>
</font></span></div></div>
</blockquote></span></div><br></div></div>
</blockquote></span></div><span class="gmail-HOEnZb"><font color="#888888"><br><br clear="all"><div><br></div>-- <br><div><div dir="ltr"><div><div dir="ltr"><div>Anne Gentle</div><div><a target="_blank" style="font-size:12.8px" href="http://www.justwriteclick.com">www.justwriteclick.com</a><br></div></div></div></div></div>
</font></span></div></div>
</blockquote></div><br></div></div>