Solr
  1. Solr
  2. SOLR-1848

Add example Query page to the example

    Details

    • Type: Improvement Improvement
    • Status: Open
    • Priority: Trivial Trivial
    • Resolution: Unresolved
    • Affects Version/s: None
    • Fix Version/s: None
    • Component/s: None
    • Labels:
      None

      Description

      I've wired up a static jetty context and hooked in a simple HTML page that shows off a bunch of the different types of queries people can do w/ the Example data. Browse to it at http://localhost:8983/example/queries.html

      Will commit shortly.

        Activity

        Hide
        Lance Norskog added a comment -

        Maybe there could be a Solr Apps project somewhere else with all of these cool things like the tutorial, clustering, Uri's lovely GWT browser, spatial demos, etc. A simple content management store that lets you index & save PDFs and then search & display them.

        For one thing, it would be worthwhile to cleave these away from relying on moment-by-moment changes in the core source base.

        Show
        Lance Norskog added a comment - Maybe there could be a Solr Apps project somewhere else with all of these cool things like the tutorial, clustering, Uri's lovely GWT browser, spatial demos, etc. A simple content management store that lets you index & save PDFs and then search & display them. For one thing, it would be worthwhile to cleave these away from relying on moment-by-moment changes in the core source base.
        Hide
        Grant Ingersoll added a comment -

        I was just trying to solve something I find to be very annoying in Solr: I just want some quick examples that are part of the actual example that I can go click on and try out w/o having to go chasing all over creation to find them (wiki, tutorial, various websites, etc.) Not too mention there is no simple "reference" for these examples, all of those things (wiki, tutorial) have a ton of verbiage around them. For instance, you have to scroll quite a long way in the tutorial to even get to a sample query. I just want a dumb little page, (ideally, it would actually be the landing page when hitting http://localhost:8983/solr when using the example) that shows me examples of interacting with Solr. I can click on the link, get results and then introspect what I just did.

        Heck, going forward, we could even distribute the example index already built so that people don't have to do the indexing until later. I often find in my training classes that I get a lot better attention when I do search first instead of indexing.

        Who knew such a simple thing was worth so much discussion.

        Show
        Grant Ingersoll added a comment - I was just trying to solve something I find to be very annoying in Solr: I just want some quick examples that are part of the actual example that I can go click on and try out w/o having to go chasing all over creation to find them (wiki, tutorial, various websites, etc.) Not too mention there is no simple "reference" for these examples, all of those things (wiki, tutorial) have a ton of verbiage around them. For instance, you have to scroll quite a long way in the tutorial to even get to a sample query. I just want a dumb little page, (ideally, it would actually be the landing page when hitting http://localhost:8983/solr when using the example) that shows me examples of interacting with Solr. I can click on the link, get results and then introspect what I just did. Heck, going forward, we could even distribute the example index already built so that people don't have to do the indexing until later. I often find in my training classes that I get a lot better attention when I do search first instead of indexing. Who knew such a simple thing was worth so much discussion.
        Hide
        Hoss Man added a comment -

        Agreed: as we start adding sections, it will maek a lot of sense to split the tutorial out into multiple pages: the (existing) intro page shoiwing how easy it is to load data and do basic queries w/faceting and highlighting, a second page showing off spatial queries, a third page showing spell check (and myabe more like this), DIH should have a page, etc...

        With the possible exception of distributed search (where multiple ports need to be up and running) there's no reason all of these things can't be demoed from a single example.

        Show
        Hoss Man added a comment - Agreed: as we start adding sections, it will maek a lot of sense to split the tutorial out into multiple pages: the (existing) intro page shoiwing how easy it is to load data and do basic queries w/faceting and highlighting, a second page showing off spatial queries, a third page showing spell check (and myabe more like this), DIH should have a page, etc... With the possible exception of distributed search (where multiple ports need to be up and running) there's no reason all of these things can't be demoed from a single example.
        Hide
        Yonik Seeley added a comment -

        Frankly though: the queries.html is so simple, i really don't understand why we wouldn't just expand the tutorial to include those links.

        Spatial is a cool enough feature, it might make sense to add a little section (like faceting has) to the tutorial when it's mature enough. As long as it's easy and simple enough though... it seems like one of the primary goals of the tutorial should be to give users a feeling of accomplishment and a feeling of "this solr stuff is easy to use!".

        Show
        Yonik Seeley added a comment - Frankly though: the queries.html is so simple, i really don't understand why we wouldn't just expand the tutorial to include those links. Spatial is a cool enough feature, it might make sense to add a little section (like faceting has) to the tutorial when it's mature enough. As long as it's easy and simple enough though... it seems like one of the primary goals of the tutorial should be to give users a feeling of accomplishment and a feeling of "this solr stuff is easy to use!".
        Hide
        Hoss Man added a comment -

        I'm confused by yonik's comment...

        bq .What's the motivation for including them in the solr webapp?

        I agree, adding things to solr.war just for the purpose of the example/tutorial is a bad idea, but from what i can tell Grant's commit didn't do that – it just added configuration so that people running "java -jar start.jar" had both the solr webapp running as well as a "static" webapp containing a form. if they copied the solr.war file, or the "example/solr" home they wouldn't be affected at all.

        I suppose for people who copy the entire example directory there might be some unnecessary stuff – but that's going to always be true (unless we get rid of exampledocs)

        Frankly though: the queries.html is so simple, i really don't understand why we wouldn't just expand the tutorial to include those links.

        Show
        Hoss Man added a comment - I'm confused by yonik's comment... bq .What's the motivation for including them in the solr webapp? I agree, adding things to solr.war just for the purpose of the example/tutorial is a bad idea, but from what i can tell Grant's commit didn't do that – it just added configuration so that people running "java -jar start.jar" had both the solr webapp running as well as a "static" webapp containing a form. if they copied the solr.war file, or the "example/solr" home they wouldn't be affected at all. I suppose for people who copy the entire example directory there might be some unnecessary stuff – but that's going to always be true (unless we get rid of exampledocs) Frankly though: the queries.html is so simple, i really don't understand why we wouldn't just expand the tutorial to include those links.
        Hide
        Yonik Seeley added a comment -

        OK, I've reverted this for now.
        If people want changes to the current tutorial structure, we can have more discussion to hash out the best way to achieve that.

        Show
        Yonik Seeley added a comment - OK, I've reverted this for now. If people want changes to the current tutorial structure, we can have more discussion to hash out the best way to achieve that.
        Hide
        Yonik Seeley added a comment -

        Just b/c you don't find something useful doesn't mean others won't.

        Of course... but one could use such an argument to support anything.
        In this specific case, it doesn't seem like there is enough benefit to outweigh the additional complexity.

        Show
        Yonik Seeley added a comment - Just b/c you don't find something useful doesn't mean others won't. Of course... but one could use such an argument to support anything. In this specific case, it doesn't seem like there is enough benefit to outweigh the additional complexity.
        Hide
        Yonik Seeley added a comment -

        I guess an argument could also be made for putting the whole tutorial page in the example server.
        But it's certainly something that warrants discussion.

        Show
        Yonik Seeley added a comment - I guess an argument could also be made for putting the whole tutorial page in the example server. But it's certainly something that warrants discussion.
        Hide
        Grant Ingersoll added a comment - - edited

        Whatever. Do as you wish. Just b/c you don't find something useful doesn't mean others won't.

        Show
        Grant Ingersoll added a comment - - edited Whatever. Do as you wish. Just b/c you don't find something useful doesn't mean others won't.
        Hide
        Yonik Seeley added a comment -

        If it's not worth the discussion, hopefully you won't mind if it's reverted then?

        Show
        Yonik Seeley added a comment - If it's not worth the discussion, hopefully you won't mind if it's reverted then?
        Hide
        Grant Ingersoll added a comment -

        Seriously, Yonik? This is worth the discussion? It's a jetty context file and a static HTML page that contains some handy examples of how to work with Solr w/o going all over the place.

        Show
        Grant Ingersoll added a comment - Seriously, Yonik? This is worth the discussion? It's a jetty context file and a static HTML page that contains some handy examples of how to work with Solr w/o going all over the place.
        Hide
        Yonik Seeley added a comment -

        This also complicates setting up with different servlet containers. Someone can't drop the solr.war into tomcat, or in a different jetty container, and follow along with the tutorial anymore. I think we should revert this and keep things simple.

        Show
        Yonik Seeley added a comment - This also complicates setting up with different servlet containers. Someone can't drop the solr.war into tomcat, or in a different jetty container, and follow along with the tutorial anymore. I think we should revert this and keep things simple.
        Hide
        Yonik Seeley added a comment -

        I believe the tutorial is already shipped in the solr download.

        Show
        Yonik Seeley added a comment - I believe the tutorial is already shipped in the solr download.
        Hide
        Grant Ingersoll added a comment -

        B/c you don't always have access to those. This is nice and handy and concise and included in the example w/o having to go looking all around. If anything, the tutorial should be shipped w/ the example.

        Show
        Grant Ingersoll added a comment - B/c you don't always have access to those. This is nice and handy and concise and included in the example w/o having to go looking all around. If anything, the tutorial should be shipped w/ the example.
        Hide
        Yonik Seeley added a comment -

        What's the motivation for including them in the solr webapp?
        Stuff like this works fine from the tutorial on the website, or from a wiki page.

        And I've been trying to get rid of the extra directories in "example", not add more

        Show
        Yonik Seeley added a comment - What's the motivation for including them in the solr webapp? Stuff like this works fine from the tutorial on the website, or from a wiki page. And I've been trying to get rid of the extra directories in "example", not add more
        Show
        Grant Ingersoll added a comment - Make that http://localhost:8983/solr/example/queries.html

          People

          • Assignee:
            Unassigned
            Reporter:
            Grant Ingersoll
          • Votes:
            1 Vote for this issue
            Watchers:
            0 Start watching this issue

            Dates

            • Created:
              Updated:

              Development