[openstack-dev] [nova][docs] O search where art thou?

Anne Gentle annegentle at justwriteclick.com
Fri Aug 11 14:53:26 UTC 2017


On Fri, Aug 11, 2017 at 9:26 AM, Doug Hellmann <doug at doughellmann.com> wrote:
> Excerpts from Sean Dague's message of 2017-08-11 09:10:59 -0400:
>> On 08/11/2017 08:50 AM, Anne Gentle | Just Write Click wrote:
>> > Yeah, I need to circle back in the theme work to make sure both search scopes are available. My prior attempt had some wonky CSS debugging and I needed to separate patches more.
>> >
>> > I'll put up another patch to the theme today to bring in the Sphinx search in the sidebar as it was before.
>> >
>> > I'm not sure how to solve the sort problem Sean notes, would like help there.
>> > Hope this helps -
>> > Anne
>>
>> If we have the option to use sphinx baked in search, instead of the
>> bounce out to google swift_search that's being installed, it's all
>> solved. The sphinx search builds the search terms into a compiled
>> javascript file on build, and will only link to content in the tree.
>>
>> I think the thing to do is probably enhance openstackdocstheme to have
>> some toggle of "local_search = True" which would get rid of swift_search
>> and just use baked in local search. Then on a per site basic people
>> could turn it on / off, and openstackdocstheme could still be used for
>> sites that want global search.
>>
>>     -Sean
>>
>
> We could also limit the global search to one of the top-level pages in
> the openstack-manuals repo and have the theme link to a search page
> there.
>

Mmm, I think it's simpler to keep the global search in the header
as-is across docs, www, ask, and so on. So, keep it in the header and
add an additional search form for within-project. Sound good?

Anne

> Doug
>
> __________________________________________________________________________
> OpenStack Development Mailing List (not for usage questions)
> Unsubscribe: OpenStack-dev-request at lists.openstack.org?subject:unsubscribe
> http://lists.openstack.org/cgi-bin/mailman/listinfo/openstack-dev



More information about the OpenStack-dev mailing list