To respond to the feedback so far: Version picker: This is more complex than it may be initially assumed because of the way we publish the site. Since we use a static site generator, each page is a standalone HTML file. To add a version picker to an older version that includes all the latest versions, we'd need to republish all the older versions every time we published a new one. We could get around this by pointing a version picker to a location we update each time (but still today would need to republish all the older versions to add it at all), which was harder to do in the past due to how the Solr website as a whole was published. I wanted to try to address this problem in what I'm calling Phase 3 - moving to a different static site generator that supports multiple versions in a more native way but maybe I can find a simple stopgap until then.
Jumpiness while hovering over nav items: The font size isn't actually different when you hover or select a nav item, it's just bolded which makes it overrun the allotted space and wrap. I made it bolded in response to other feedback I got earlier on that there was not enough differentiation between selected and not-selected items but didn't notice the jumpiness (I had to make my screen quite large to duplicate it, and when I looked at the Guide on larger screens earlier I was usually looking at some other problem and just didn't notice). I'll play with it a little and find another way to differentiate the items without bolding them. Thanks for your comments so far! On Wed, Apr 29, 2020 at 2:56 AM Colvin Cowie <colvin.cowie....@gmail.com> wrote: > In addition to those points, I think it generally does look good but the > thing I've noticed is that increase in text size on rollover in the menu > makes it quite jumpy: > https://drive.google.com/open?id=15EF0T_C_l8OIDuW8QHOFunL4VzxtyVyb > > On Wed, 29 Apr 2020 at 08:15, Bernd Fehling < > bernd.fehl...@uni-bielefeld.de> > wrote: > > > +1 > > > > And a fully indexed search for the Ref Guide. > > I have to use Google to search for infos in Ref Guide of a search engine. > > :-( > > > > > > Am 29.04.20 um 02:11 schrieb matthew sporleder: > > > I highly recommend a version selector in the header! I am *always* > > > landing on 6.x docs from google. > > > > > > On Tue, Apr 28, 2020 at 5:18 PM Cassandra Targett <ctarg...@apache.org > > > > wrote: > > >> > > >> In case the list breaks the URL to view the Jenkins build, here's a > > shorter > > >> URL: > > >> > > >> https://s.apache.org/df7ew. > > >> > > >> On Tue, Apr 28, 2020 at 3:12 PM Cassandra Targett < > ctarg...@apache.org> > > >> wrote: > > >> > > >>> The PMC would like to engage the Solr user community for feedback on > an > > >>> extensive redesign of the Solr Reference Guide I've just committed to > > the > > >>> master (future 9.0) branch. > > >>> > > >>> You can see the new design from our Jenkins build of master: > > >>> > > >>> > > > https://builds.apache.org/view/L/view/Lucene/job/Solr-reference-guide-master/javadoc/ > > >>> > > >>> The hope is that you will receive these changes positively. If so, > > we'll > > >>> use this for the upcoming 8.6 Ref Guide and future releases. We also > > may > > >>> re-publish earlier 8.x versions so they use this design. > > >>> > > >>> I embarked on this project last December simply as an attempt to > > upgrade > > >>> the version of Bootstrap used by the Guide. After a couple of days, > I'd > > >>> changed the layout entirely. In the ensuing few months I've tried to > > iron > > >>> out the kinks and made some extensive changes to the "backend" (the > > CSS, > > >>> JavaScript, etc.). > > >>> > > >>> I'm no graphic designer, but some of my guiding thoughts were to try > to > > >>> make full use of the browser window, improve responsiveness for > > different > > >>> sized screens, and just give it a more modern feel. The full list of > > what > > >>> has changed is detailed in the Jira issue if you are interested: > > >>> https://issues.apache.org/jira/browse/SOLR-14173 > > >>> > > >>> This is Phase 1 of several changes. There is one glaring remaining > > issue, > > >>> which is that our list of top-level categories is too long for the > new > > >>> design. I've punted fixing that to Phase 2, which will be an > extensive > > >>> re-consideration of how the Ref Guide is organized with the goal of > > >>> trimming down the top-level categories to only 4-6. SOLR-14444 will > > track > > >>> phase 2. > > >>> > > >>> One last thing to note: this redesign really only changes the > > presentation > > >>> of the pages and some of the framework under the hood - it doesn't > yet > > add > > >>> full-text search. All of the obstacles to providing search still > > exist, but > > >>> please know that we fully understand frustration on this point and > > still > > >>> hope to fix it. > > >>> > > >>> I look forward to hearing your feedback in this thread. > > >>> > > >>> Best, > > >>> Cassandra > > >>> > > >
