Someone needs to update the Ref Guide. That can be a patch submitted on a JIRA issue, or a committer could forego a patch and make changes directly with commits.
Otherwise, this wiki page is making a bad situation even worse. On Tue, May 29, 2018 at 12:06 PM Tim Allison <talli...@apache.org> wrote: > I’m happy to contribute to this message in any way I can. Let me know how > I can help. > > On Tue, May 29, 2018 at 2:31 PM Cassandra Targett <casstarg...@gmail.com> > wrote: > > > It's not as simple as a banner. Information was added to the wiki that > does > > not exist in the Ref Guide. > > > > Before you say "go look at the Ref Guide" you need to make sure it says > > what you want it to say, and the creation of this page just 3 days ago > > indicates to me that the Ref Guide is missing something. > > > > On Tue, May 29, 2018 at 1:04 PM Erick Erickson <erickerick...@gmail.com> > > wrote: > > > > > On further reflection ,+1 to marking the Wiki page superseded by the > > > reference guide. I'd be fine with putting a banner at the top of all > > > the Wiki pages saying "check the Solr reference guide first" ;) > > > > > > On Tue, May 29, 2018 at 10:59 AM, Cassandra Targett > > > <casstarg...@gmail.com> wrote: > > > > Couldn't the same information on that page be put into the Solr Ref > > > Guide? > > > > > > > > I mean, if that's what we recommend, it should be documented > officially > > > > that it's what we recommend. > > > > > > > > I mean, is anyone surprised people keep stumbling over this? Shawn's > > wiki > > > > page doesn't point to the Ref Guide (instead pointing at other wiki > > pages > > > > that are out of date) and the Ref Guide doesn't point to that page. > So > > > half > > > > the info is in our "official" place but the real story is in another > > > place, > > > > one we alternately tell people to sometimes ignore but sometimes keep > > up > > > to > > > > date? Even I'm confused. > > > > > > > > On Sat, May 26, 2018 at 6:41 PM Erick Erickson < > > erickerick...@gmail.com> > > > > wrote: > > > > > > > >> Thanks! now I can just record the URL and then paste it in ;) > > > >> > > > >> Who knows, maybe people will see it first too! > > > >> > > > >> On Sat, May 26, 2018 at 9:48 AM, Tim Allison <talli...@apache.org> > > > wrote: > > > >> > W00t! Thank you, Shawn! > > > >> > > > > >> > The "don't use ERH in production" response comes up frequently > > enough > > > >> >> that I have created a wiki page we can use for responses: > > > >> >> > > > >> >> https://wiki.apache.org/solr/RecommendCustomIndexingWithTika > > > >> >> > > > >> >> Tim, you are extremely well-qualified to expand and correct this > > > page. > > > >> >> Erick may be interested in making adjustments also. The flow of > the > > > page > > > >> >> feels a little bit awkward to me, but I'm not sure how to improve > > it. > > > >> >> > > > >> >> If the page name is substandard, feel free to rename. I've > already > > > >> >> renamed it once! I searched for an existing page like this > before > > I > > > >> >> started creating it. I did put a link to the new page on the > > > >> >> ExtractingRequestHandler page. > > > >> >> > > > >> >> Thanks, > > > >> >> Shawn > > > >> >> > > > >> >> > > > >> > > > > > >