<div dir="ltr">Generally speaking, we should link the first occurrence of an "unusual" term or acronym in a particular file to the glossary. Linking every occurrence becomes difficult to manage. Also, we might want to consider purging terms or acronyms with definitions not specific to OpenStack because people can easily look them up via generic search.</div><div class="gmail_extra"><br><div class="gmail_quote">On Mon, Jul 25, 2016 at 6:55 AM, Foley, Emma L <span dir="ltr"><<a href="mailto:emma.l.foley@intel.com" target="_blank">emma.l.foley@intel.com</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Hi all,<br>
<br>
There are 712 terms defined in the glossary [1].<br>
There are 165 references to the glossary terms throughout the openstack-manuals repo [2].<br>
<br>
In my opinion, the glossary is there to explain terms in the context of OpenStack, so that users don't have to look up terms that they are unfamiliar with and try to fit it back into the right context.<br>
By adding more links to glossary terms in the manuals, users will have a better experience coming to terms with OpenStack.<br>
I've been using OpenStack for quite a while at this stage, and wasn't aware that there was a glossary until recently.<br>
<br>
My questions are:<br>
- Do references to the glossary need to increase?<br>
- Do I need to register a blueprint?<br>
<br>
Regards,<br>
Emma<br>
<br>
[1] grep "^   [A-Z,a-z]" glossary.rst | wc -l<br>
[2] <a href="https://github.com/openstack/openstack-manuals/search?utf8=%E2%9C%93&q=%3Aterm%3A" rel="noreferrer" target="_blank">https://github.com/openstack/openstack-manuals/search?utf8=%E2%9C%93&q=%3Aterm%3A</a><br>
--------------------------------------------------------------<br>
Intel Research and Development Ireland Limited<br>
Registered in Ireland<br>
Registered Office: Collinstown Industrial Park, Leixlip, County Kildare<br>
Registered Number: 308263<br>
<br>
<br>
<br>
_______________________________________________<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" rel="noreferrer" target="_blank">http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-docs</a><br>
</blockquote></div><br></div>