You are viewing a plain text version of this content. The canonical link for it is here.
Posted to commits@bloodhound.apache.org by Apache Bloodhound <de...@bloodhound.apache.org> on 2013/07/25 12:37:27 UTC

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

#232: Nudge users towards understanding search syntax
--------------------------+---------------------
  Reporter:  jdreimann    |      Owner:  nobody
      Type:  enhancement  |     Status:  new
  Priority:  trivial      |  Milestone:
 Component:  ui design    |    Version:
Resolution:               |   Keywords:  starter
--------------------------+---------------------

Comment (by mudri):

 "TracLink" gets replaced automatically with "Guide/Link", which doesn't
 read as well. I've instead decided to call them "Wiki links":
 {{{
 #!xml
 Index: bloodhound_theme/bhtheme/templates/bh_search.html
 ===================================================================
 --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision 1505634)
 +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working copy)
 @@ -100,8 +100,11 @@

      <div id="help" class="help-block pull-right" i18n:msg="">
        <span class="label label-info">Note:</span>
 -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
 -      for help on searching.
 +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
 +      for help on searching.<br />
 +      <span class="label label-info">Tip:</span>
 +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
 +      to jump directly to a page.
      </div>
      <br/>
 }}}
 {{{
 #!xml
 Index: bloodhound_search/bhsearch/templates/bhsearch.html
 ===================================================================
 --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision 1505634)
 +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working copy)
 @@ -192,10 +192,14 @@
        </div>

        <div id="help" class="help-block pull-right" i18n:msg="">
 -        <strong>Note:</strong> See <a
 href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
 -        for help on searching.
 +        <span class="label label-info">Note:</span>
 +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
 +        for help on searching.<br />
 +        <span class="label label-info">Tip:</span>
 +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
 +        to jump directly to a page.
        </div>

      </div>
    </body>
 -</html>
 \ No newline at end of file
 +</html>
 }}}
 {{{
 #!css
 Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
 ===================================================================
 --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision 1505634)
 +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working copy)
 @@ -1281,3 +1281,20 @@
  input[type="radio"]:not(:checked) + label span {
   text-decoration:underline;
  }
 +
 +#help.pull-right {
 + text-align: right;
 +}
 }}}

-- 
Ticket URL: <https://issues.apache.org/bloodhound/ticket/232#comment:4>
Apache Bloodhound <https://issues.apache.org/bloodhound/>
The Apache Bloodhound issue tracker

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by James Wood <ja...@wandisco.com>.
Or, rather than "(Guide/Links)" add "(try '#1')" or some other example.


On Thu, Jul 25, 2013 at 5:18 PM, James Wood <ja...@wandisco.com> wrote:

> Hmm... the tooltip might be distracting. As for the other options, it's a
> case of new placeholder text vs. bottom-of-page tip + shortened
> placeholder. A possible new placeholder is "Search for or link to a page",
> which fits in an .input-large. We can add "(Guide/Links)" and still fit in
> an .input-xlarge. But is it clear enough on its own?
>
>
>
> On Thu, Jul 25, 2013 at 4:01 PM, Joachim Dreimann <
> joachim.dreimann@wandisco.com> wrote:
>
>> On 25 July 2013 15:29, James Wood <ja...@wandisco.com> wrote:
>>
>> > On this one, I noticed that the search box already has
>> placeholder="Search
>> > all products. Try TracLinks.", but it has been cut off due to the box
>> not
>> > being wide enough. It could be wider (I don't see what's wrong with it
>> > going up to .input-xlarge), but I don't think it fits in a descriptive
>> > enough message. Also, I'm under the impression that we're removing
>> > references to Trac in the interface.
>> >
>> >
>> So what's your suggestion? Should we remove (part of) the placeholder
>> text?
>> Could we use a tooltip[1] to display some help text instead when the
>> search
>> input box is focussed?
>>
>> - Joe
>>
>> [1] http://twitter.github.io/bootstrap/javascript.html#tooltips
>>
>>
>> >
>> > On Thu, Jul 25, 2013 at 11:58 AM, James Wood <james.wood@wandisco.com
>> > >wrote:
>> >
>> > >
>> > >
>> > >
>> > > On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
>> > > dev@bloodhound.apache.org> wrote:
>> > >
>> > >> #232: Nudge users towards understanding search syntax
>> > >> --------------------------+---------------------
>> > >>   Reporter:  jdreimann    |      Owner:  nobody
>> > >>       Type:  enhancement  |     Status:  new
>> > >>   Priority:  trivial      |  Milestone:
>> > >>  Component:  ui design    |    Version:
>> > >> Resolution:               |   Keywords:  starter
>> > >> --------------------------+---------------------
>> > >>
>> > >> Comment (by mudri):
>> > >>
>> > >>  "TracLink" gets replaced automatically with "Guide/Link", which
>> doesn't
>> > >>  read as well. I've instead decided to call them "Wiki links":
>> > >>  {{{
>> > >>  #!xml
>> > >>  Index: bloodhound_theme/bhtheme/templates/bh_search.html
>> > >>  ===================================================================
>> > >>  --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision
>> > >> 1505634)
>> > >>  +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working
>> copy)
>> > >>  @@ -100,8 +100,11 @@
>> > >>
>> > >>       <div id="help" class="help-block pull-right" i18n:msg="">
>> > >>         <span class="label label-info">Note:</span>
>> > >>  -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
>> > >>  -      for help on searching.
>> > >>  +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>> > >>  +      for help on searching.<br />
>> > >>  +      <span class="label label-info">Tip:</span>
>> > >>  +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>> > >>  +      to jump directly to a page.
>> > >>       </div>
>> > >>       <br/>
>> > >>  }}}
>> > >>  {{{
>> > >>  #!xml
>> > >>  Index: bloodhound_search/bhsearch/templates/bhsearch.html
>> > >>  ===================================================================
>> > >>  --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision
>> > >> 1505634)
>> > >>  +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working
>> copy)
>> > >>  @@ -192,10 +192,14 @@
>> > >>         </div>
>> > >>
>> > >>         <div id="help" class="help-block pull-right" i18n:msg="">
>> > >>  -        <strong>Note:</strong> See <a
>> > >>  href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
>> > >>  -        for help on searching.
>> > >>  +        <span class="label label-info">Note:</span>
>> > >>  +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>> > >>  +        for help on searching.<br />
>> > >>  +        <span class="label label-info">Tip:</span>
>> > >>  +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>> > >>  +        to jump directly to a page.
>> > >>         </div>
>> > >>
>> > >>       </div>
>> > >>     </body>
>> > >>  -</html>
>> > >>  \ No newline at end of file
>> > >>  +</html>
>> > >>  }}}
>> > >>  {{{
>> > >>  #!css
>> > >>  Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
>> > >>  ===================================================================
>> > >>  --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision
>> > >> 1505634)
>> > >>  +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working
>> copy)
>> > >>  @@ -1281,3 +1281,20 @@
>> > >>   input[type="radio"]:not(:checked) + label span {
>> > >>    text-decoration:underline;
>> > >>   }
>> > >>  +
>> > >>  +#help.pull-right {
>> > >>  + text-align: right;
>> > >>  +}
>> > >>  }}}
>> > >>
>> > >> --
>> > >> Ticket URL: <
>> https://issues.apache.org/bloodhound/ticket/232#comment:4>
>> > >> Apache Bloodhound <https://issues.apache.org/bloodhound/>
>> > >> The Apache Bloodhound issue tracker
>> > >>
>> > >
>> > >
>> >
>>
>>
>>
>> --
>> Joachim Dreimann | *User Experience Manager*
>>
>> WANdisco // *Non-Stop Data*
>>
>> e. joachim.dreimann@wandisco.com
>> twitter @jdreimann <https://twitter.com/jdreimann>
>>
>
>

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by Olemis Lang <ol...@gmail.com>.
On 8/8/13, Ryan Ollos <ry...@wandisco.com> wrote:
[...]
> I also like the idea of making the
> search box larger, as long as we take care to ensure it looks okay on
> mobile.
>

IMO the size of search box is ok .

[...]

-- 
Regards,

Olemis - @olemislc

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by Ryan Ollos <ry...@wandisco.com>.
On Fri, Jul 26, 2013 at 2:44 PM, Joe Dreimann <joachim.dreimann@wandisco.com
> wrote:

>
> On 25 Jul 2013, at 17:18, James Wood <ja...@wandisco.com> wrote:
>
> > Hmm... the tooltip might be distracting. As for the other options, it's a
> > case of new placeholder text vs. bottom-of-page tip + shortened
> > placeholder. A possible new placeholder is "Search for or link to a
> page",
> > which fits in an .input-large. We can add "(Guide/Links)" and still fit
> in
> > an .input-xlarge. But is it clear enough on its own?
>
> I don't think that would be very clear. "Link to a page" doesn't really
> make sense in a search context.
>
> What Trac links are to be understood as in this context is a way to jump
> straight to content without having to see the search results.
>
> Maybe we just don't need this at all, just all the placeholder 'Search
> anything'.
>
> - Joe


"Search anything" or "Search through all products" sounds good to me.
Additional placeholder or tooltip text such as "or quickjump to a resource"
might help if it can be made to fit. I also like the idea of making the
search box larger, as long as we take care to ensure it looks okay on
mobile.

The help links at the bottom of the page are likely to go unnoticed by the
users that need to be most aware of them. I think we need to somehow get
the search help link closer to the Search button, but I'm not sure of the
best way to do that. Somewhat related, I suggested adding a help icon next
to the help text added in t:#11257, but I didn't get any feedback on the
idea.
http://trac.edgewall.org/ticket/11257#comment:description

If we are looking for a replacement for "TracLinks", "ResourceLinks" might
be a good fit.

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by Joe Dreimann <jo...@wandisco.com>.
On 25 Jul 2013, at 17:18, James Wood <ja...@wandisco.com> wrote:

> Hmm... the tooltip might be distracting. As for the other options, it's a
> case of new placeholder text vs. bottom-of-page tip + shortened
> placeholder. A possible new placeholder is "Search for or link to a page",
> which fits in an .input-large. We can add "(Guide/Links)" and still fit in
> an .input-xlarge. But is it clear enough on its own?

I don't think that would be very clear. "Link to a page" doesn't really make sense in a search context.

What Trac links are to be understood as in this context is a way to jump straight to content without having to see the search results.

Maybe we just don't need this at all, just all the placeholder 'Search anything'.

- Joe

> 
> 
> On Thu, Jul 25, 2013 at 4:01 PM, Joachim Dreimann <
> joachim.dreimann@wandisco.com> wrote:
> 
>> On 25 July 2013 15:29, James Wood <ja...@wandisco.com> wrote:
>> 
>>> On this one, I noticed that the search box already has
>> placeholder="Search
>>> all products. Try TracLinks.", but it has been cut off due to the box not
>>> being wide enough. It could be wider (I don't see what's wrong with it
>>> going up to .input-xlarge), but I don't think it fits in a descriptive
>>> enough message. Also, I'm under the impression that we're removing
>>> references to Trac in the interface.
>> So what's your suggestion? Should we remove (part of) the placeholder text?
>> Could we use a tooltip[1] to display some help text instead when the search
>> input box is focussed?
>> 
>> - Joe
>> 
>> [1] http://twitter.github.io/bootstrap/javascript.html#tooltips
>> 
>> 
>>> 
>>> On Thu, Jul 25, 2013 at 11:58 AM, James Wood <james.wood@wandisco.com
>>>> wrote:
>>> 
>>>> 
>>>> 
>>>> 
>>>> On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
>>>> dev@bloodhound.apache.org> wrote:
>>>> 
>>>>> #232: Nudge users towards understanding search syntax
>>>>> --------------------------+---------------------
>>>>>  Reporter:  jdreimann    |      Owner:  nobody
>>>>>      Type:  enhancement  |     Status:  new
>>>>>  Priority:  trivial      |  Milestone:
>>>>> Component:  ui design    |    Version:
>>>>> Resolution:               |   Keywords:  starter
>>>>> --------------------------+---------------------
>>>>> 
>>>>> Comment (by mudri):
>>>>> 
>>>>> "TracLink" gets replaced automatically with "Guide/Link", which
>> doesn't
>>>>> read as well. I've instead decided to call them "Wiki links":
>>>>> {{{
>>>>> #!xml
>>>>> Index: bloodhound_theme/bhtheme/templates/bh_search.html
>>>>> ===================================================================
>>>>> --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision
>>>>> 1505634)
>>>>> +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working
>> copy)
>>>>> @@ -100,8 +100,11 @@
>>>>> 
>>>>>      <div id="help" class="help-block pull-right" i18n:msg="">
>>>>>        <span class="label label-info">Note:</span>
>>>>> -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
>>>>> -      for help on searching.
>>>>> +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>>>>> +      for help on searching.<br />
>>>>> +      <span class="label label-info">Tip:</span>
>>>>> +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>>>>> +      to jump directly to a page.
>>>>>      </div>
>>>>>      <br/>
>>>>> }}}
>>>>> {{{
>>>>> #!xml
>>>>> Index: bloodhound_search/bhsearch/templates/bhsearch.html
>>>>> ===================================================================
>>>>> --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision
>>>>> 1505634)
>>>>> +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working
>> copy)
>>>>> @@ -192,10 +192,14 @@
>>>>>        </div>
>>>>> 
>>>>>        <div id="help" class="help-block pull-right" i18n:msg="">
>>>>> -        <strong>Note:</strong> See <a
>>>>> href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
>>>>> -        for help on searching.
>>>>> +        <span class="label label-info">Note:</span>
>>>>> +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>>>>> +        for help on searching.<br />
>>>>> +        <span class="label label-info">Tip:</span>
>>>>> +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>>>>> +        to jump directly to a page.
>>>>>        </div>
>>>>> 
>>>>>      </div>
>>>>>    </body>
>>>>> -</html>
>>>>> \ No newline at end of file
>>>>> +</html>
>>>>> }}}
>>>>> {{{
>>>>> #!css
>>>>> Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
>>>>> ===================================================================
>>>>> --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision
>>>>> 1505634)
>>>>> +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working
>> copy)
>>>>> @@ -1281,3 +1281,20 @@
>>>>>  input[type="radio"]:not(:checked) + label span {
>>>>>   text-decoration:underline;
>>>>>  }
>>>>> +
>>>>> +#help.pull-right {
>>>>> + text-align: right;
>>>>> +}
>>>>> }}}
>>>>> 
>>>>> --
>>>>> Ticket URL: <
>> https://issues.apache.org/bloodhound/ticket/232#comment:4>
>>>>> Apache Bloodhound <https://issues.apache.org/bloodhound/>
>>>>> The Apache Bloodhound issue tracker
>> 
>> 
>> 
>> --
>> Joachim Dreimann | *User Experience Manager*
>> 
>> WANdisco // *Non-Stop Data*
>> 
>> e. joachim.dreimann@wandisco.com
>> twitter @jdreimann <https://twitter.com/jdreimann>
>> 

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by James Wood <ja...@wandisco.com>.
Hmm... the tooltip might be distracting. As for the other options, it's a
case of new placeholder text vs. bottom-of-page tip + shortened
placeholder. A possible new placeholder is "Search for or link to a page",
which fits in an .input-large. We can add "(Guide/Links)" and still fit in
an .input-xlarge. But is it clear enough on its own?


On Thu, Jul 25, 2013 at 4:01 PM, Joachim Dreimann <
joachim.dreimann@wandisco.com> wrote:

> On 25 July 2013 15:29, James Wood <ja...@wandisco.com> wrote:
>
> > On this one, I noticed that the search box already has
> placeholder="Search
> > all products. Try TracLinks.", but it has been cut off due to the box not
> > being wide enough. It could be wider (I don't see what's wrong with it
> > going up to .input-xlarge), but I don't think it fits in a descriptive
> > enough message. Also, I'm under the impression that we're removing
> > references to Trac in the interface.
> >
> >
> So what's your suggestion? Should we remove (part of) the placeholder text?
> Could we use a tooltip[1] to display some help text instead when the search
> input box is focussed?
>
> - Joe
>
> [1] http://twitter.github.io/bootstrap/javascript.html#tooltips
>
>
> >
> > On Thu, Jul 25, 2013 at 11:58 AM, James Wood <james.wood@wandisco.com
> > >wrote:
> >
> > >
> > >
> > >
> > > On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
> > > dev@bloodhound.apache.org> wrote:
> > >
> > >> #232: Nudge users towards understanding search syntax
> > >> --------------------------+---------------------
> > >>   Reporter:  jdreimann    |      Owner:  nobody
> > >>       Type:  enhancement  |     Status:  new
> > >>   Priority:  trivial      |  Milestone:
> > >>  Component:  ui design    |    Version:
> > >> Resolution:               |   Keywords:  starter
> > >> --------------------------+---------------------
> > >>
> > >> Comment (by mudri):
> > >>
> > >>  "TracLink" gets replaced automatically with "Guide/Link", which
> doesn't
> > >>  read as well. I've instead decided to call them "Wiki links":
> > >>  {{{
> > >>  #!xml
> > >>  Index: bloodhound_theme/bhtheme/templates/bh_search.html
> > >>  ===================================================================
> > >>  --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision
> > >> 1505634)
> > >>  +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working
> copy)
> > >>  @@ -100,8 +100,11 @@
> > >>
> > >>       <div id="help" class="help-block pull-right" i18n:msg="">
> > >>         <span class="label label-info">Note:</span>
> > >>  -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
> > >>  -      for help on searching.
> > >>  +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
> > >>  +      for help on searching.<br />
> > >>  +      <span class="label label-info">Tip:</span>
> > >>  +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
> > >>  +      to jump directly to a page.
> > >>       </div>
> > >>       <br/>
> > >>  }}}
> > >>  {{{
> > >>  #!xml
> > >>  Index: bloodhound_search/bhsearch/templates/bhsearch.html
> > >>  ===================================================================
> > >>  --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision
> > >> 1505634)
> > >>  +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working
> copy)
> > >>  @@ -192,10 +192,14 @@
> > >>         </div>
> > >>
> > >>         <div id="help" class="help-block pull-right" i18n:msg="">
> > >>  -        <strong>Note:</strong> See <a
> > >>  href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
> > >>  -        for help on searching.
> > >>  +        <span class="label label-info">Note:</span>
> > >>  +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
> > >>  +        for help on searching.<br />
> > >>  +        <span class="label label-info">Tip:</span>
> > >>  +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
> > >>  +        to jump directly to a page.
> > >>         </div>
> > >>
> > >>       </div>
> > >>     </body>
> > >>  -</html>
> > >>  \ No newline at end of file
> > >>  +</html>
> > >>  }}}
> > >>  {{{
> > >>  #!css
> > >>  Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
> > >>  ===================================================================
> > >>  --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision
> > >> 1505634)
> > >>  +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working
> copy)
> > >>  @@ -1281,3 +1281,20 @@
> > >>   input[type="radio"]:not(:checked) + label span {
> > >>    text-decoration:underline;
> > >>   }
> > >>  +
> > >>  +#help.pull-right {
> > >>  + text-align: right;
> > >>  +}
> > >>  }}}
> > >>
> > >> --
> > >> Ticket URL: <
> https://issues.apache.org/bloodhound/ticket/232#comment:4>
> > >> Apache Bloodhound <https://issues.apache.org/bloodhound/>
> > >> The Apache Bloodhound issue tracker
> > >>
> > >
> > >
> >
>
>
>
> --
> Joachim Dreimann | *User Experience Manager*
>
> WANdisco // *Non-Stop Data*
>
> e. joachim.dreimann@wandisco.com
> twitter @jdreimann <https://twitter.com/jdreimann>
>

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by Joachim Dreimann <jo...@wandisco.com>.
On 25 July 2013 15:29, James Wood <ja...@wandisco.com> wrote:

> On this one, I noticed that the search box already has placeholder="Search
> all products. Try TracLinks.", but it has been cut off due to the box not
> being wide enough. It could be wider (I don't see what's wrong with it
> going up to .input-xlarge), but I don't think it fits in a descriptive
> enough message. Also, I'm under the impression that we're removing
> references to Trac in the interface.
>
>
So what's your suggestion? Should we remove (part of) the placeholder text?
Could we use a tooltip[1] to display some help text instead when the search
input box is focussed?

- Joe

[1] http://twitter.github.io/bootstrap/javascript.html#tooltips


>
> On Thu, Jul 25, 2013 at 11:58 AM, James Wood <james.wood@wandisco.com
> >wrote:
>
> >
> >
> >
> > On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
> > dev@bloodhound.apache.org> wrote:
> >
> >> #232: Nudge users towards understanding search syntax
> >> --------------------------+---------------------
> >>   Reporter:  jdreimann    |      Owner:  nobody
> >>       Type:  enhancement  |     Status:  new
> >>   Priority:  trivial      |  Milestone:
> >>  Component:  ui design    |    Version:
> >> Resolution:               |   Keywords:  starter
> >> --------------------------+---------------------
> >>
> >> Comment (by mudri):
> >>
> >>  "TracLink" gets replaced automatically with "Guide/Link", which doesn't
> >>  read as well. I've instead decided to call them "Wiki links":
> >>  {{{
> >>  #!xml
> >>  Index: bloodhound_theme/bhtheme/templates/bh_search.html
> >>  ===================================================================
> >>  --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision
> >> 1505634)
> >>  +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working copy)
> >>  @@ -100,8 +100,11 @@
> >>
> >>       <div id="help" class="help-block pull-right" i18n:msg="">
> >>         <span class="label label-info">Note:</span>
> >>  -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
> >>  -      for help on searching.
> >>  +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
> >>  +      for help on searching.<br />
> >>  +      <span class="label label-info">Tip:</span>
> >>  +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
> >>  +      to jump directly to a page.
> >>       </div>
> >>       <br/>
> >>  }}}
> >>  {{{
> >>  #!xml
> >>  Index: bloodhound_search/bhsearch/templates/bhsearch.html
> >>  ===================================================================
> >>  --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision
> >> 1505634)
> >>  +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working copy)
> >>  @@ -192,10 +192,14 @@
> >>         </div>
> >>
> >>         <div id="help" class="help-block pull-right" i18n:msg="">
> >>  -        <strong>Note:</strong> See <a
> >>  href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
> >>  -        for help on searching.
> >>  +        <span class="label label-info">Note:</span>
> >>  +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
> >>  +        for help on searching.<br />
> >>  +        <span class="label label-info">Tip:</span>
> >>  +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
> >>  +        to jump directly to a page.
> >>         </div>
> >>
> >>       </div>
> >>     </body>
> >>  -</html>
> >>  \ No newline at end of file
> >>  +</html>
> >>  }}}
> >>  {{{
> >>  #!css
> >>  Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
> >>  ===================================================================
> >>  --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision
> >> 1505634)
> >>  +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working copy)
> >>  @@ -1281,3 +1281,20 @@
> >>   input[type="radio"]:not(:checked) + label span {
> >>    text-decoration:underline;
> >>   }
> >>  +
> >>  +#help.pull-right {
> >>  + text-align: right;
> >>  +}
> >>  }}}
> >>
> >> --
> >> Ticket URL: <https://issues.apache.org/bloodhound/ticket/232#comment:4>
> >> Apache Bloodhound <https://issues.apache.org/bloodhound/>
> >> The Apache Bloodhound issue tracker
> >>
> >
> >
>



-- 
Joachim Dreimann | *User Experience Manager*

WANdisco // *Non-Stop Data*

e. joachim.dreimann@wandisco.com
twitter @jdreimann <https://twitter.com/jdreimann>

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by James Wood <ja...@wandisco.com>.
On this one, I noticed that the search box already has placeholder="Search
all products. Try TracLinks.", but it has been cut off due to the box not
being wide enough. It could be wider (I don't see what's wrong with it
going up to .input-xlarge), but I don't think it fits in a descriptive
enough message. Also, I'm under the impression that we're removing
references to Trac in the interface.


On Thu, Jul 25, 2013 at 11:58 AM, James Wood <ja...@wandisco.com>wrote:

>
>
>
> On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
> dev@bloodhound.apache.org> wrote:
>
>> #232: Nudge users towards understanding search syntax
>> --------------------------+---------------------
>>   Reporter:  jdreimann    |      Owner:  nobody
>>       Type:  enhancement  |     Status:  new
>>   Priority:  trivial      |  Milestone:
>>  Component:  ui design    |    Version:
>> Resolution:               |   Keywords:  starter
>> --------------------------+---------------------
>>
>> Comment (by mudri):
>>
>>  "TracLink" gets replaced automatically with "Guide/Link", which doesn't
>>  read as well. I've instead decided to call them "Wiki links":
>>  {{{
>>  #!xml
>>  Index: bloodhound_theme/bhtheme/templates/bh_search.html
>>  ===================================================================
>>  --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision
>> 1505634)
>>  +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working copy)
>>  @@ -100,8 +100,11 @@
>>
>>       <div id="help" class="help-block pull-right" i18n:msg="">
>>         <span class="label label-info">Note:</span>
>>  -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
>>  -      for help on searching.
>>  +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>>  +      for help on searching.<br />
>>  +      <span class="label label-info">Tip:</span>
>>  +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>>  +      to jump directly to a page.
>>       </div>
>>       <br/>
>>  }}}
>>  {{{
>>  #!xml
>>  Index: bloodhound_search/bhsearch/templates/bhsearch.html
>>  ===================================================================
>>  --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision
>> 1505634)
>>  +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working copy)
>>  @@ -192,10 +192,14 @@
>>         </div>
>>
>>         <div id="help" class="help-block pull-right" i18n:msg="">
>>  -        <strong>Note:</strong> See <a
>>  href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
>>  -        for help on searching.
>>  +        <span class="label label-info">Note:</span>
>>  +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>>  +        for help on searching.<br />
>>  +        <span class="label label-info">Tip:</span>
>>  +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>>  +        to jump directly to a page.
>>         </div>
>>
>>       </div>
>>     </body>
>>  -</html>
>>  \ No newline at end of file
>>  +</html>
>>  }}}
>>  {{{
>>  #!css
>>  Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
>>  ===================================================================
>>  --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision
>> 1505634)
>>  +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working copy)
>>  @@ -1281,3 +1281,20 @@
>>   input[type="radio"]:not(:checked) + label span {
>>    text-decoration:underline;
>>   }
>>  +
>>  +#help.pull-right {
>>  + text-align: right;
>>  +}
>>  }}}
>>
>> --
>> Ticket URL: <https://issues.apache.org/bloodhound/ticket/232#comment:4>
>> Apache Bloodhound <https://issues.apache.org/bloodhound/>
>> The Apache Bloodhound issue tracker
>>
>
>

Re: [Apache Bloodhound] #232: Nudge users towards understanding search syntax

Posted by James Wood <ja...@wandisco.com>.
On Thu, Jul 25, 2013 at 11:37 AM, Apache Bloodhound <
dev@bloodhound.apache.org> wrote:

> #232: Nudge users towards understanding search syntax
> --------------------------+---------------------
>   Reporter:  jdreimann    |      Owner:  nobody
>       Type:  enhancement  |     Status:  new
>   Priority:  trivial      |  Milestone:
>  Component:  ui design    |    Version:
> Resolution:               |   Keywords:  starter
> --------------------------+---------------------
>
> Comment (by mudri):
>
>  "TracLink" gets replaced automatically with "Guide/Link", which doesn't
>  read as well. I've instead decided to call them "Wiki links":
>  {{{
>  #!xml
>  Index: bloodhound_theme/bhtheme/templates/bh_search.html
>  ===================================================================
>  --- bloodhound_theme/bhtheme/templates/bh_search.html   (revision 1505634)
>  +++ bloodhound_theme/bhtheme/templates/bh_search.html   (working copy)
>  @@ -100,8 +100,11 @@
>
>       <div id="help" class="help-block pull-right" i18n:msg="">
>         <span class="label label-info">Note:</span>
>  -      See <a href="${href.wiki('TracSearch')}">TracSearch</a>
>  -      for help on searching.
>  +      See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>  +      for help on searching.<br />
>  +      <span class="label label-info">Tip:</span>
>  +      Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>  +      to jump directly to a page.
>       </div>
>       <br/>
>  }}}
>  {{{
>  #!xml
>  Index: bloodhound_search/bhsearch/templates/bhsearch.html
>  ===================================================================
>  --- bloodhound_search/bhsearch/templates/bhsearch.html  (revision 1505634)
>  +++ bloodhound_search/bhsearch/templates/bhsearch.html  (working copy)
>  @@ -192,10 +192,14 @@
>         </div>
>
>         <div id="help" class="help-block pull-right" i18n:msg="">
>  -        <strong>Note:</strong> See <a
>  href="${href.wiki('BloodhoundSearch')}">BloodhoundSearch</a>
>  -        for help on searching.
>  +        <span class="label label-info">Note:</span>
>  +        See <a href="${href.wiki('Guide/Search')}">Guide/Search</a>
>  +        for help on searching.<br />
>  +        <span class="label label-info">Tip:</span>
>  +        Enter a <a href="${href.wiki('Guide/Links')}">Wiki link</a>
>  +        to jump directly to a page.
>         </div>
>
>       </div>
>     </body>
>  -</html>
>  \ No newline at end of file
>  +</html>
>  }}}
>  {{{
>  #!css
>  Index: bloodhound_theme/bhtheme/htdocs/bloodhound.css
>  ===================================================================
>  --- bloodhound_theme/bhtheme/htdocs/bloodhound.css      (revision 1505634)
>  +++ bloodhound_theme/bhtheme/htdocs/bloodhound.css      (working copy)
>  @@ -1281,3 +1281,20 @@
>   input[type="radio"]:not(:checked) + label span {
>    text-decoration:underline;
>   }
>  +
>  +#help.pull-right {
>  + text-align: right;
>  +}
>  }}}
>
> --
> Ticket URL: <https://issues.apache.org/bloodhound/ticket/232#comment:4>
> Apache Bloodhound <https://issues.apache.org/bloodhound/>
> The Apache Bloodhound issue tracker
>